- id
- 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
- url
- 该记录在原平台上的可访问链接。
- text
- 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
- media_type
- 媒体类型。
- video_url
- 视频播放地址（带签名、会过期，要留存请及时下载）；图文笔记或来源没给时为 null。
- like_count
- 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
- comment_count
- 评论数。null 表示不公开，不等于 0。
- share_count
- 分享/转发数。null 表示不公开，不等于 0。
- collect_count
- 收藏数。null 表示不公开，不等于 0。
- author_name
- 作者昵称（显示名）。
- author_id
- 作者在原平台的唯一 ID。
- author_douyin_id
- 作者抖音号。
- author_avatar_url
- 作者头像链接：search / user_posts / video 行上是博主的，comments 行上是评论者的。
- cover_image_url
- 作品封面图链接（search / user_posts 行上）。
- author_follower_count
- 作者粉丝数。null 表示不公开。
- posted_at
- 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
- platform
- 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
- duration_sec
- 视频时长（秒）。
- duration_seconds
- 时长，单位秒。非视频/音频内容为 null。
- hashtags
- 正文里的话题标签数组，按出现顺序；没有时不出现这个字段。
- view_count
- 播放量。抖音不对外公开播放量：多数结果没有这个字段，有时为 0，都不代表真实播放；判断视频热度请用 like_count(点赞)、comment_count、share_count。
- region
- 地区。
- author_uid
- 作者（评论里是评论者）的数字用户 ID；author_id 是 secUid，两者是同一个人的两种 ID。
- author_is_verified
- 作者是否认证（search / user_posts / video 行上）。
- author_bio
- 作者主页简介（search / user_posts / video 行上）。
- author_following_count
- 作者关注数（search / user_posts / video 行上）。
- author_like_count
- 作者主页获赞总数（search / user_posts / video / transcript）。
- author_video_count
- 作者作品总数（search / user_posts / video 行上）。
- author_ip_location
- 作者 IP 属地（平台强制展示）。
- title
- 标题。平台无标题概念时（如纯文本帖）为 null。
- music
- 作品背景音乐：id、title（曲名）、author（演唱/作者）、is_original（是否原声）、duration_sec（秒）、cover_url、play_url（音频地址，可能会过期）；没有音乐信息时没有这个键。
- download_count
- 作品下载数。
- forward_count
- 作品转发数。
- is_pinned
- 是否置顶（作品行：作者主页置顶作品；trending：榜单置顶词）。
- is_ad
- 是否为广告作品。
- video_tags
- 平台给作品打的内容分类标签（如「美食」「探店」）。
- video_width
- 视频画面宽度（像素）。
- video_height
- 视频画面高度（像素）。
- video_resolution
- 视频清晰度档位原文（如 720p）。
- animated_cover_url
- 动态封面链接。
- image_urls
- 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。
- user_id
- 用户在原平台的唯一 ID。
- douyin_id
- 抖音号（用户自定义的可搜索 ID）。
- nickname
- 昵称。
- bio
- 个人简介，账号自己填写的文本。可能含换行和 emoji。
- follower_count
- 粉丝数。null 表示不公开，不等于 0。
- following_count
- 关注数。null 表示不公开，不等于 0。
- video_count
- 视频数：profile 是账号的作品数，trending 是这个热点下的相关视频数。
- gender
- 性别。
- ip_location
- IP 属地（平台强制展示，非用户填写）。
- is_verified
- 是否为平台认证账号（蓝V等）。null 表示无法判定。
- avatar_url
- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
- uid
- 数字用户 ID（profile / creator_search）；user_id 是 secUid，两者是同一账号的两种 ID。
- background_image_url
- 主页背景图链接。
- country
- 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
- language
- 内容语言代码（如 zh、en），由平台判定，可能不准。
- is_live
- 账号在采集时是否正在直播；属于时点状态。
- likes_given_count
- 主页公开的「喜欢」数（该账号点过赞的作品数）。
- has_shop
- 账号是否开通商品橱窗。
- verify_reason
- 认证说明原文（profile / creator_search），企业认证或个人认证的文字；未认证的账号为空或没有这个字段。
- next_page_token
- 翻页令牌（user_posts / comments）：作为下一次请求的 page_token 原样传回取下一页（其余参数不变，24 小时内有效）；同一页每行的值相同，响应顶层也有同一个 next_page_token。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
- reply_count
- 回复数，通常用于评论的子回复。null 表示不公开。
- is_hot
- 该评论是否带「热评」标记（comments）。
- is_reply
- 是否为回复。
- reply_to_id
- 被回复评论 ID。
- video_id
- 评论所属视频 ID（comments）。
- liked_by_author
- 评论是否被作者点赞。作者亲自点赞的评论互动价值高。
- images
- 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。
- mentioned_users
- 评论里 @ 到的人：user_id（secUid）、uid（数字 ID）、nickname；没有 @ 时没有这个键。
- rank
- 名次：trending 是热榜排名，xingtu_creator_rankings 是星图榜单里的名次。
- keyword
- 热点关键词。
- hot_value
- 热榜热度值。抖音自有指标，只在同一榜单内可比；热点榜（hotspot）的行上常常为空。
- board
- 所属榜单。
- image_url
- 图片链接。多图能力可能返回 image_urls 数组。
- event_time
- 热点事件时间。
- sentence_id
- 热点词 ID（trending）。
- group_id
- 热点事件 ID（trending）；部分热点为空。
- label
- 热榜角标代码（trending，数字，如热、新、爆）；0 表示没有角标。
- word_type
- 热点词类型代码（trending，数字）。
- article_count
- 热点下的相关图文数（trending）。
- max_rank
- 该热点在榜单上的历史最高名次（trending）。
- live_room_count
- 热点下的相关直播间数（trending）。
- play_count
- 播放量。抖音不对外公开播放量，这里的值（多为 0）不代表真实播放；热度判断请用点赞/评论/分享数。
- author_avatar
- 作者头像。
- segments
- 转写的逐句时间轴（transcript）：每句带 start、end（秒）和 text。
- audio_url
- 视频音轨地址（transcript，mp3，可能会过期）。
- recommend_count
- 作品的推荐数（transcript）。
- source_keyword
- 本行命中的搜索关键词。
- audience_distribution
- 粉丝受众分布桶；value 是 0–1 的份额小数，不是百分数、人数或实际买家占比。
- audience_tgi
- 受众桶相对平台平均的 TGI 指数；与份额 value 是独立量纲，不是人数或成交占比。
- dimension_code
- 画像维度：device_price_band、gender、age 或 province；由请求 option 映射，不把领先分布桶标签当维度。
- follower_trend
- 粉丝数量随日期变化的序列。
- average_follower_count
- 趋势窗口内的平均粉丝量。
- average_post_count
- 对标窗口内的平均发布量。
- average_comment_count
- 对标窗口内的平均评论量。
- average_share_count
- 对标窗口内的平均分享量。
- average_follower_growth
- 对标窗口内的平均新增粉丝量。
- average_like_count
- 对标窗口内的平均点赞量。
- post_count_percentile
- 发布量在同类账号中的百分位。
- comment_count_percentile
- 评论量在同类账号中的百分位。
- share_count_percentile
- 分享量在同类账号中的百分位。
- follower_growth_percentile
- 新增粉丝量在同类账号中的百分位。
- like_count_percentile
- 点赞量在同类账号中的百分位。
- creator_id
- 星图商业达人稳定 ID；不是公开主页 user_id 或抖音号。
- city
- 城市名，用原平台的语言书写，未做中英归一。
- creator_score
- 星图达人综合指数；只在同一次取得的结果中比较。
- engagement_rate_30d
- 星图近 30 天互动率。
- expected_play_count
- 星图预期播放量；属于平台估计，不是实际播放结果。
- expected_natural_play_count
- 星图预期自然播放量；属于平台估计。
- interaction_median_30d
- 星图近 30 天互动量中位数。
- play_over_rate_30d
- 星图近 30 天完播率。
- follower_growth_30d
- 星图近 30 天涨粉量。
- follower_growth_rate_15d
- 星图近 15 天涨粉率。
- content_themes
- 平台给达人标记的内容主题标签。
- ecommerce_level
- 星图电商能力等级。
- ecommerce_score
- 星图电商能力分；是平台指标，不是实际成交额。
- gmv_30d_range
- 星图近 30 天 GMV 区间；是区间/估计，不是精确成交额。
- gpm_30d_range
- 星图近 30 天 GPM 区间字符串；不改写为精确值。
- average_order_value_30d_range
- 星图近 30 天客单价区间字符串；不是真实订单明细。
- commercial_index
- 星图商业价值指数。
- conversion_index
- 星图转化能力指数。
- spread_index
- 星图传播能力指数。
- shopping_index
- 星图种草能力指数。
- quote_1_20s_cny
- 1–20 秒视频报价，人民币元。
- quote_20_60s_cny
- 20–60 秒视频报价，人民币元。
- quote_60s_plus_cny
- 60 秒以上视频报价，人民币元。
- creator_type
- 星图返回的达人类型。
- average_play_count
- 星图返回的平均播放量。
- category_id
- 星图达人分类 ID。
- tags
- 标签数组。无标签时为空数组，不是 null。
- creator_grade
- 星图达人等级。
- is_xingtu_creator
- 是否为星图达人。
- ecommerce_enabled
- 是否具备星图电商能力标记。
- lowest_quote_cny
- 星图展示的最低合作报价，人民币；是报价，不是成交价。
- rate_tiers
- 星图报价档位；每档保留形式说明、实际报价、原报价、结算说明、视频类型与开放状态。
- cpm_cny
- 星图榜单展示的千次曝光成本，人民币元。
- completed_order_range
- 已完成品牌合作订单的平台区间字符串；不是精确订单数。
- repurchase_rate_range
- 客户复购率的平台区间字符串；不是精确比率。
- item_order_rate
- 星图展示的内容下单率。
- average_view_count
- 榜单快照内的平均视频播放量。
- previous_rank
- 同榜单上一期排名。
- ranking_score
- 星图榜单综合分；只在同一榜单与时间窗内比较。
- is_new
- 是否为本期新进榜达人。
- ranking_board
- 星图榜单展示名称。
- period_days
- 榜单统计周期天数。
- snapshot_date
- 榜单快照日期，格式 YYYYMMDD。
- source_kind
- 数据来源类型；当前公开契约只接受并返回 ranking。
- product_id
- 抖音商城商品稳定 ID。
- promotion_id
- 抖音带货计划中的推广 ID。
- white_image_url
- 商品白底图 URL。
- price_cny
- 商品展示价格，人民币元。
- price_cny_minor
- 商品展示价格，人民币分的整数值。
- price_label
- 商品价格标签，例如到手价。
- monthly_sales
- 商品近 30 天销量。
- good_review_ratio
- 商品好评率百分比。
- sales_trend
- 商品近 30 天每日销量序列。
- category_path
- 商品从一级到叶子类目的名称路径。
- category_ids
- 商品类目 ID 路径，与 category_path 同序（product_search）。
- category_depth
- 商品类目路径深度。
- shop_id
- 抖音商城店铺 ID。
- shop_name
- 抖音商城店铺名称。
- shop_logo_url
- 店铺 Logo URL，可能带有效期。
- shop_score
- 店铺公开体验分（如有）。
- commission_rate_percent
- 公开带货佣金比例。
- commission_cny
- 按当前展示价计算的佣金金额，人民币。
- cooperating_creator_count
- 商品带货计划显示的合作达人数；不能反推某位指定达人卖过该商品。
- search_rank
- 商品在该关键词自然搜索结果中的位置。
- recommend_reason
- 商品搜索结果上的推荐理由原文（product_search）；没有时没有这个键。
- discount_price_cny
- 商品当前公开优惠价，人民币元；缺失时不从原价推算。
- sales_text
- 商品详情公开销量原文。
- sold_count
- 商品详情当前公开的已售数量；是采集时快照，不等于指定达人销量。
- shop_avatar_url
- 抖音商城店铺头像 URL。
- main_image_urls
- 商品头图/轮播图 URL 列表。
- detail_image_urls
- 商品详情长图 URL 列表。
- assurances
- 商品公开服务保障标签。
- shipping_fee_text
- 商品公开运费或发货地说明原文。
- shipping_estimate_text
- 商品公开预计发货说明原文。
- variant_groups
- 商品规格组与可选项；只保留规格名、选项名和公开规格 ID。
- on_sale
- 商品在采集时是否显示在售。
- sku_id
- 抖音商城 SKU ID；与商品 product_id 不是同一标识。
- live_room_id
- 采集时挂载该商品的直播间 ID；只表示当前直播搜索命中。
- is_live_product
- 是否由当前直播商品搜索明确返回；不是历史直播归因。
