{"platform":"douyin","action":null,"common_fields":{"id":"该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。","url":"该记录在原平台上的可访问链接。","text":"正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。","like_count":"点赞数。null 表示该平台或该接口不公开此数据，不等于 0。","comment_count":"评论数。null 表示不公开，不等于 0。","share_count":"分享/转发数。null 表示不公开，不等于 0。","collect_count":"收藏数。null 表示不公开，不等于 0。","author_name":"作者昵称（显示名）。","author_id":"作者在原平台的唯一 ID。","author_follower_count":"作者粉丝数。null 表示不公开。","duration_seconds":"时长，单位秒。非视频/音频内容为 null。","hashtags":"正文里的话题标签数组，按出现顺序；没有时不出现这个字段。","posted_at":"发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。","platform":"数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。","image_urls":"图片链接数组，按平台展示顺序；没有图片时不出现这个字段。","title":"标题。平台无标题概念时（如纯文本帖）为 null。","user_id":"用户在原平台的唯一 ID。","bio":"个人简介，账号自己填写的文本。可能含换行和 emoji。","follower_count":"粉丝数。null 表示不公开，不等于 0。","following_count":"关注数。null 表示不公开，不等于 0。","is_verified":"是否为平台认证账号（蓝V等）。null 表示无法判定。","avatar_url":"头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。","country":"国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。","language":"内容语言代码（如 zh、en），由平台判定，可能不准。","reply_count":"回复数，通常用于评论的子回复。null 表示不公开。","images":"图片链接数组，按平台展示顺序；没有图片时不出现这个字段。","image_url":"图片链接。多图能力可能返回 image_urls 数组。","tags":"标签数组。无标签时为空数组，不是 null。","created_at":"创建时间，格式同 posted_at。","category":"分类名称，取值为原平台的分类体系，未做跨平台归一。"},"platform_fields":{"next_page_token":"翻页令牌（search / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search / billboard_rise_list / billboard_topic_hot）：作为下一次请求的 page_token 原样传回取下一页（其余参数不变，24 小时内有效）；同一页每行的值相同，响应顶层也有同一个 next_page_token。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。","media_type":"媒体类型。","video_url":"视频播放地址（带签名、会过期，要留存请及时下载）；图文笔记或来源没给时为 null。","view_count":"播放量。抖音不对外公开播放量：多数结果没有这个字段，有时为 0，都不代表真实播放；判断视频热度请用 like_count(点赞)、comment_count、share_count。","author_douyin_id":"作者抖音号。","author_uid":"作者（评论里是评论者）的数字用户 ID；author_id 是 secUid，两者是同一个人的两种 ID。","author_bio":"作者主页简介（search / user_posts / video 行上）。","author_avatar_url":"作者头像链接：search / user_posts / video 行上是博主的，comments 行上是评论者的。","cover_image_url":"封面图链接：search / user_posts 是作品封面，music_search / music_detail 是音乐封面，billboard_topic_hot 是话题配图。","video_width":"视频画面宽度（像素）。","video_height":"视频画面高度（像素）。","region":"地区。","duration_sec":"视频时长（秒）。","hashtag_ids":"作品话题 ID 列表，与 hashtags 同序一一对应（search / user_posts / video）。","search_rank":"在这次关键词搜索结果里的名次（从 1 开始）：product_search 行是商品，search 行是作品，hashtag_search 行是话题。","author_is_verified":"作者是否认证（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 属地（平台强制展示）。","music":"作品背景音乐：id、title（曲名）、author（演唱/作者）、is_original（是否原声）、duration_sec（秒）、cover_url、play_url（音频地址，可能会过期）；没有音乐信息时没有这个键。","download_count":"作品下载数。","forward_count":"作品转发数。","is_pinned":"是否置顶（作品行：作者主页置顶作品；trending：榜单置顶词）。","is_ad":"是否为广告作品。","video_tags":"平台给作品打的内容分类标签（如「美食」「探店」）。","video_resolution":"视频清晰度档位原文（如 720p）。","animated_cover_url":"动态封面链接。","city":"城市：作品行（search / user_posts / video）是作品发布城市，平台给的是拼音写法（如 Suzhou）；xingtu_creator_rankings 是达人所在城市。","city_code":"作品发布城市的行政区划代码（如 320500）。","location":"作品定位的地点（POI）：id、name、category（地点分类）、address、district、city、province、country、city_code、latitude、longitude、cover_url、popularity_text（如 327人想去）、view_count、post_count（该地点下的作品数）、collect_count、visitor_count；作品没带定位时没有这个键。","text_language":"作品文案语言代码（如 zh；un 表示未识别）。","video_bitrates":"各清晰度播放地址：[{quality（清晰度名）, bitrate（码率，bps）, fps, is_h265（是否 H.265 编码）, url}]；地址带签名、会过期（见 video_url_expires_at）。","download_url":"作品视频的下载地址（带签名、会过期）。","has_watermark":"平台对这条作品视频文件的水印标记（true 表示带水印）。","video_url_expires_at":"播放与下载地址的失效时间（ISO 8601，UTC）；之后要重新取。","permissions":"作者给作品设的权限：can_comment（可评论）、can_download（可下载）、can_duet（可合拍）、can_stitch（可拼接）、can_share（可分享）、can_repost（可转发）、can_save（可保存）；只含平台给了的项。","author_gender":"作者性别（male / female / unknown，作者自己填的）。","author_age":"作者年龄（作者公开了才有）。","douyin_id":"抖音号（用户自定义的可搜索 ID）。","nickname":"昵称。","video_count":"视频数：profile、billboard_account_search 是账号的作品数，trending、billboard_rise_list、billboard_challenge_hot 是这个热点下的相关视频数。","gender":"性别。","ip_location":"IP 属地（平台强制展示，非用户填写）。","uid":"数字用户 ID（profile / creator_search）；user_id 是 secUid，两者是同一账号的两种 ID。","background_image_url":"主页背景图链接。","is_live":"账号在采集时是否正在直播；属于时点状态。","likes_given_count":"主页公开的「喜欢」数（该账号点过赞的作品数）。","has_shop":"账号是否开通商品橱窗。","age":"账号主人年龄（profile；公开了才有）。","has_series":"账号是否开通了合集/系列（profile）。","verify_reason":"认证说明原文（profile / creator_search），企业认证或个人认证的文字；未认证的账号为空或没有这个字段。","is_hot":"该评论是否带「热评」标记（comments）。","is_reply":"是否为回复。","reply_to_id":"被回复评论 ID：comments 的回复行上是它挂在哪条顶层评论下；comment_replies 每行都是请求的那条顶层评论。","video_id":"评论所属视频 ID（comments）。","liked_by_author":"评论是否被作者点赞。作者亲自点赞的评论互动价值高。","mentioned_users":"评论里 @ 到的人：user_id（secUid）、uid（数字 ID）、nickname；没有 @ 时没有这个键。","reply_to_reply_id":"这条回复回复的是楼里另一条回复时，那条回复的 ID（comment_replies）；直接回复顶层评论时没有这个键。","reply_to_author_name":"被回复的那条回复的作者昵称，和 reply_to_reply_id 同时出现（comment_replies）。","rank":"名次（从 1 开始）：trending 是热榜排名，xingtu_creator_rankings 是星图榜单里的名次，billboard_search_hot 是搜索热榜名次，search_suggest 是联想词在抖音搜索框里的顺序；billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次（翻页接着往下数）。","keyword":"关键词：trending 是热点词，billboard_search_hot 是上榜的搜索词，search_suggest 是抖音给出的联想搜索词。","hot_value":"热度值，抖音自有指标，只在同一榜单、同一时间窗内可比：trending 是热榜热度（热点榜 hotspot 的行上常常为空）；热点宝视频榜（billboard_video_hot 等）是榜单热度分，行按它从高到低排；billboard_search_hot 是这个词在时间窗里的搜索热度；billboard_rise_list、billboard_challenge_hot 是热点热度，billboard_topic_hot 是话题在时间窗里的热度分。","board":"所属榜单。","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）。","topic_view_count":"热点的浏览量（trending）；与 hot_value 是两个指标。null 表示没给，不等于 0。","sentence_tag":"热点分类代码（trending，数字）；同一代码是同一类热点。","label_icon_url":"热榜角标图链接（trending，如「热」「新」）；文字代码见 label。","related_music_id":"热点关联的背景音乐 ID（trending，部分热点有）。","play_count":"播放量。热点宝榜单（billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion）上是平台统计的播放数；其余能力上抖音不对外公开播放量，这里的值（多为 0）不代表真实播放，热度判断请用点赞/评论/分享数。","author_avatar":"作者头像。","segments":"转写的逐句时间轴（transcript）：每句带 start、end（秒）和 text。","audio_url":"音频地址：transcript 是视频音轨（mp3），music_search、music_detail 是这段音乐的播放地址；可能会过期。","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 或抖音号。","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。","creator_grade":"星图达人等级。","is_xingtu_creator":"是否为星图达人。","ecommerce_enabled":"是否具备星图电商能力标记。","lowest_quote_cny":"星图展示的最低合作报价；单位未经核实，请勿直接用于报价。是报价，不是成交价。","rate_tiers":"星图报价档位；每档保留形式说明、实际报价（price_cny）、原报价（list_price_cny）、结算说明、视频类型与开放状态；报价单位是人民币元。","cpm_cny":"星图榜单展示的千次曝光成本，人民币元。","completed_order_range":"已完成品牌合作订单的平台区间字符串；不是精确订单数。","repurchase_rate_range":"客户复购率的平台区间字符串；不是精确比率。","item_order_rate":"星图展示的内容下单率。","average_view_count":"榜单快照内的平均视频播放量；话题榜（billboard_topic_hot）是话题下作品的平均播放量。","previous_rank":"同榜单上一期排名。","ranking_score":"星图榜单综合分；只在同一榜单与时间窗内比较。","is_new":"是否为本期新进榜达人。","ranking_board":"星图榜单展示名称。","period_days":"榜单统计周期天数。","snapshot_date":"榜单快照日期，格式 YYYYMMDD。","industry_tags":"达人行业标签（xingtu_creator_rankings，如 生活）。","primary_tag":"达人主内容标签（xingtu_creator_rankings，如 随拍）。","industry_id":"星图行业 ID（xingtu_creator_rankings），与 industry 对应。","top_videos":"达人代表作品（xingtu_creator_rankings）：[{id, url, play_count（播放数）}]。","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":"商品带货计划显示的合作达人数；不能反推某位指定达人卖过该商品。","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":"是否由当前直播商品搜索明确返回；不是历史直播归因。","hashtag_id":"话题 ID（纯数字字符串）；作为 hashtag_detail 的 hashtag_id 传回可读这个话题的累计数据。","hashtag_name":"话题名，不带 #。","heat_index":"话题在统计时段里的热度指数（hashtag_search），抖音自有指标，只在同一次结果里比较。","period_video_count":"统计时段里这个话题下的作品数（hashtag_search）。","period_like_count":"统计时段里这个话题下作品获得的点赞数（hashtag_search）。","period_view_count":"统计时段里这个话题下作品的播放量（hashtag_search），是平台给的话题统计。","period_start":"统计时段第一天，YYYY-MM-DD（hashtag_search）；固定是到中国时间昨天为止的最近 7 天。","period_end":"统计时段最后一天，YYYY-MM-DD（hashtag_search），即中国时间的昨天。","total_view_count":"话题累计播放量（hashtag_detail、billboard_topic_hot），从话题创建起算，是平台给的话题统计。","participant_count":"参与过这个话题的用户数（hashtag_detail），累计值。","image_count":"图文作品的图片张数（热点宝视频榜，media_type 为 image 时才有）。","like_rate":"点赞率（热点宝视频榜）：like_count ÷ play_count，小数，如 0.0118 即 1.18%。","new_follower_count":"这条作品带来的新增关注数（热点宝视频榜）。","follower_growth_rate":"涨粉率（热点宝视频榜）：平台给的小数，约等于 new_follower_count ÷ play_count。","search_trend":"这个搜索词的逐日搜索热度（billboard_search_hot）：[{date（YYYY-MM-DD）, value}]，日期从早到晚、最后一天是最近一个完整日（中国时间），最多 14 天（新上榜的词更短）；默认时间窗 1d 下最后一天的 value 等于 hot_value。","use_count":"用这段音乐发过的作品数（music_search、music_detail），即抖音音乐页上的「N 人使用」。","lyric_url":"歌词文件链接（music_search、music_detail，平台给了才有）。","rank_change":"名次变化（billboard_rise_list）：比上一次榜单快照上升了几名，负数是下降。","topic_id":"热点宝里这个热点的 ID（billboard_rise_list、billboard_challenge_hot），同一热点在不同时间的榜上相同。","hot_trend":"这个热点最近的热度走势（billboard_rise_list 按小时、billboard_challenge_hot 约每 10 分钟一个点）：[{time（UTC，ISO 8601）, hot_value}]，从早到晚。","total_video_count":"话题下累计作品数（billboard_topic_hot）。","daily_trend":"这个话题的逐日热度（billboard_topic_hot）：[{date（YYYY-MM-DD，中国日期）, value}]，从早到晚，最多 14 天。","time_window":"统计时间窗（xingtu_conversion_ability）：7d / 30d / 90d，与请求一致。","related_video_count":"时间窗内星图统计转化数据用到的视频数（xingtu_conversion_ability）。","video_play_median":"这些视频的播放量中位数（xingtu_conversion_ability）。","component_click_count_range":"组件点击量区间（xingtu_conversion_ability），星图给的区间写法原样给，如 500-1000、500以下。","component_click_rate_range":"组件点击率区间（xingtu_conversion_ability），如 10%以上、2%以下。","cpc_range_cny":"单次点击成本区间（CPC，xingtu_conversion_ability），人民币元，如 6-8。","gpm_range_cny":"GPM 区间（每千次播放带来的成交额，xingtu_conversion_ability），人民币元，如 10-30。","average_sales_range_cny":"平均销售额区间（xingtu_conversion_ability），人民币元，如 2000-5000；达人在星图关掉销售额展示后没有这一项。","product_count":"时间窗内带货的商品数（xingtu_conversion_ability）。","product_price_range_cny":"带货商品价格区间（xingtu_conversion_ability），人民币元。","categories":"xingtu_conversion_ability：带货品类分布 [{name 品类, share 占比（0–1）, sales_range_cny 销售额区间}]，有带货时才有；xingtu_touch_distribution：连接用户来源的内容类目，最多三层 [{name 类目, touch_count 数量, subcategories 下一层（同结构）}]。","link_type":"星图给达人的连接类型（xingtu_link_structure），中文原样给，如 传播、种草。","total_user_count":"星图连接用户总数（xingtu_link_structure），等于 levels 四档人数之和。","total_rank_top_percent":"连接用户总数在星图达人中的排名位置（xingtu_link_structure），0–1，越小越靠前：0.0456 即前 4.56%。","levels":"星图连接用户的四档（xingtu_link_structure），按星图的档位编号 1–4：[{level, user_count 人数, share 占总数比例（0–1）, industry_median_user_count 同行业达人这一档人数的中位数}]。","signature_videos":"星图主页的代表作（xingtu_recommended_videos）：[{id, url, play_count 播放量, posted_at 发布时间}]；星图这几组只给这四项。","latest_videos":"xingtu_recommended_videos：星图主页上的最新作品，字段同 signature_videos；xingtu_video_performance：最近的作品（约 15 条），另有 title、like_count、comment_count、share_count、duration_seconds、is_hot（是否热门）。","top_xingtu_order_videos":"星图商单作品里播放最高的（xingtu_recommended_videos），字段同 signature_videos；没接过商单时没有这一项。","top_personal_videos":"个人作品里播放最高的（xingtu_recommended_videos），字段同 signature_videos。","personal_videos":"个人视频的三项指标（xingtu_video_performance）：engagement_rate 互动率、play_count_median 播放量中位数、completion_rate 完播率；每项 {value 本值, platform_average 星图给的全平台平均值（各达人相同）, percentile 超过了多少比例的达人（0–1）}；统计期内没有个人作品时没有这一项。","xingtu_videos":"星图商单视频的三项指标（xingtu_video_performance），结构同 personal_videos；统计期内没有星图商单作品时没有这一项。","latest_xingtu_videos":"最近的星图商单作品（xingtu_video_performance），字段同 latest_videos。"},"fields":{"next_page_token":"翻页令牌（search / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search / billboard_rise_list / billboard_topic_hot）：作为下一次请求的 page_token 原样传回取下一页（其余参数不变，24 小时内有效）；同一页每行的值相同，响应顶层也有同一个 next_page_token。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。","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。","view_count":"播放量。抖音不对外公开播放量：多数结果没有这个字段，有时为 0，都不代表真实播放；判断视频热度请用 like_count(点赞)、comment_count、share_count。","author_name":"作者昵称（显示名）。","author_id":"作者在原平台的唯一 ID。","author_douyin_id":"作者抖音号。","author_uid":"作者（评论里是评论者）的数字用户 ID；author_id 是 secUid，两者是同一个人的两种 ID。","author_bio":"作者主页简介（search / user_posts / video 行上）。","author_avatar_url":"作者头像链接：search / user_posts / video 行上是博主的，comments 行上是评论者的。","author_follower_count":"作者粉丝数。null 表示不公开。","cover_image_url":"封面图链接：search / user_posts 是作品封面，music_search / music_detail 是音乐封面，billboard_topic_hot 是话题配图。","video_width":"视频画面宽度（像素）。","video_height":"视频画面高度（像素）。","duration_seconds":"时长，单位秒。非视频/音频内容为 null。","region":"地区。","hashtags":"正文里的话题标签数组，按出现顺序；没有时不出现这个字段。","posted_at":"发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。","platform":"数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。","image_urls":"图片链接数组，按平台展示顺序；没有图片时不出现这个字段。","duration_sec":"视频时长（秒）。","hashtag_ids":"作品话题 ID 列表，与 hashtags 同序一一对应（search / user_posts / video）。","search_rank":"在这次关键词搜索结果里的名次（从 1 开始）：product_search 行是商品，search 行是作品，hashtag_search 行是话题。","author_is_verified":"作者是否认证（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_resolution":"视频清晰度档位原文（如 720p）。","animated_cover_url":"动态封面链接。","city":"城市：作品行（search / user_posts / video）是作品发布城市，平台给的是拼音写法（如 Suzhou）；xingtu_creator_rankings 是达人所在城市。","city_code":"作品发布城市的行政区划代码（如 320500）。","location":"作品定位的地点（POI）：id、name、category（地点分类）、address、district、city、province、country、city_code、latitude、longitude、cover_url、popularity_text（如 327人想去）、view_count、post_count（该地点下的作品数）、collect_count、visitor_count；作品没带定位时没有这个键。","text_language":"作品文案语言代码（如 zh；un 表示未识别）。","video_bitrates":"各清晰度播放地址：[{quality（清晰度名）, bitrate（码率，bps）, fps, is_h265（是否 H.265 编码）, url}]；地址带签名、会过期（见 video_url_expires_at）。","download_url":"作品视频的下载地址（带签名、会过期）。","has_watermark":"平台对这条作品视频文件的水印标记（true 表示带水印）。","video_url_expires_at":"播放与下载地址的失效时间（ISO 8601，UTC）；之后要重新取。","permissions":"作者给作品设的权限：can_comment（可评论）、can_download（可下载）、can_duet（可合拍）、can_stitch（可拼接）、can_share（可分享）、can_repost（可转发）、can_save（可保存）；只含平台给了的项。","author_gender":"作者性别（male / female / unknown，作者自己填的）。","author_age":"作者年龄（作者公开了才有）。","user_id":"用户在原平台的唯一 ID。","douyin_id":"抖音号（用户自定义的可搜索 ID）。","nickname":"昵称。","bio":"个人简介，账号自己填写的文本。可能含换行和 emoji。","follower_count":"粉丝数。null 表示不公开，不等于 0。","following_count":"关注数。null 表示不公开，不等于 0。","video_count":"视频数：profile、billboard_account_search 是账号的作品数，trending、billboard_rise_list、billboard_challenge_hot 是这个热点下的相关视频数。","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":"账号是否开通商品橱窗。","age":"账号主人年龄（profile；公开了才有）。","has_series":"账号是否开通了合集/系列（profile）。","verify_reason":"认证说明原文（profile / creator_search），企业认证或个人认证的文字；未认证的账号为空或没有这个字段。","reply_count":"回复数，通常用于评论的子回复。null 表示不公开。","is_hot":"该评论是否带「热评」标记（comments）。","is_reply":"是否为回复。","reply_to_id":"被回复评论 ID：comments 的回复行上是它挂在哪条顶层评论下；comment_replies 每行都是请求的那条顶层评论。","video_id":"评论所属视频 ID（comments）。","liked_by_author":"评论是否被作者点赞。作者亲自点赞的评论互动价值高。","images":"图片链接数组，按平台展示顺序；没有图片时不出现这个字段。","mentioned_users":"评论里 @ 到的人：user_id（secUid）、uid（数字 ID）、nickname；没有 @ 时没有这个键。","reply_to_reply_id":"这条回复回复的是楼里另一条回复时，那条回复的 ID（comment_replies）；直接回复顶层评论时没有这个键。","reply_to_author_name":"被回复的那条回复的作者昵称，和 reply_to_reply_id 同时出现（comment_replies）。","rank":"名次（从 1 开始）：trending 是热榜排名，xingtu_creator_rankings 是星图榜单里的名次，billboard_search_hot 是搜索热榜名次，search_suggest 是联想词在抖音搜索框里的顺序；billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次（翻页接着往下数）。","keyword":"关键词：trending 是热点词，billboard_search_hot 是上榜的搜索词，search_suggest 是抖音给出的联想搜索词。","hot_value":"热度值，抖音自有指标，只在同一榜单、同一时间窗内可比：trending 是热榜热度（热点榜 hotspot 的行上常常为空）；热点宝视频榜（billboard_video_hot 等）是榜单热度分，行按它从高到低排；billboard_search_hot 是这个词在时间窗里的搜索热度；billboard_rise_list、billboard_challenge_hot 是热点热度，billboard_topic_hot 是话题在时间窗里的热度分。","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）。","topic_view_count":"热点的浏览量（trending）；与 hot_value 是两个指标。null 表示没给，不等于 0。","sentence_tag":"热点分类代码（trending，数字）；同一代码是同一类热点。","label_icon_url":"热榜角标图链接（trending，如「热」「新」）；文字代码见 label。","related_music_id":"热点关联的背景音乐 ID（trending，部分热点有）。","play_count":"播放量。热点宝榜单（billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion）上是平台统计的播放数；其余能力上抖音不对外公开播放量，这里的值（多为 0）不代表真实播放，热度判断请用点赞/评论/分享数。","author_avatar":"作者头像。","segments":"转写的逐句时间轴（transcript）：每句带 start、end（秒）和 text。","audio_url":"音频地址：transcript 是视频音轨（mp3），music_search、music_detail 是这段音乐的播放地址；可能会过期。","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 或抖音号。","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":"星图报价档位；每档保留形式说明、实际报价（price_cny）、原报价（list_price_cny）、结算说明、视频类型与开放状态；报价单位是人民币元。","cpm_cny":"星图榜单展示的千次曝光成本，人民币元。","completed_order_range":"已完成品牌合作订单的平台区间字符串；不是精确订单数。","repurchase_rate_range":"客户复购率的平台区间字符串；不是精确比率。","item_order_rate":"星图展示的内容下单率。","average_view_count":"榜单快照内的平均视频播放量；话题榜（billboard_topic_hot）是话题下作品的平均播放量。","previous_rank":"同榜单上一期排名。","ranking_score":"星图榜单综合分；只在同一榜单与时间窗内比较。","is_new":"是否为本期新进榜达人。","ranking_board":"星图榜单展示名称。","period_days":"榜单统计周期天数。","snapshot_date":"榜单快照日期，格式 YYYYMMDD。","industry_tags":"达人行业标签（xingtu_creator_rankings，如 生活）。","primary_tag":"达人主内容标签（xingtu_creator_rankings，如 随拍）。","industry_id":"星图行业 ID（xingtu_creator_rankings），与 industry 对应。","top_videos":"达人代表作品（xingtu_creator_rankings）：[{id, url, play_count（播放数）}]。","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":"商品带货计划显示的合作达人数；不能反推某位指定达人卖过该商品。","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":"是否由当前直播商品搜索明确返回；不是历史直播归因。","hashtag_id":"话题 ID（纯数字字符串）；作为 hashtag_detail 的 hashtag_id 传回可读这个话题的累计数据。","hashtag_name":"话题名，不带 #。","heat_index":"话题在统计时段里的热度指数（hashtag_search），抖音自有指标，只在同一次结果里比较。","period_video_count":"统计时段里这个话题下的作品数（hashtag_search）。","period_like_count":"统计时段里这个话题下作品获得的点赞数（hashtag_search）。","period_view_count":"统计时段里这个话题下作品的播放量（hashtag_search），是平台给的话题统计。","period_start":"统计时段第一天，YYYY-MM-DD（hashtag_search）；固定是到中国时间昨天为止的最近 7 天。","period_end":"统计时段最后一天，YYYY-MM-DD（hashtag_search），即中国时间的昨天。","total_view_count":"话题累计播放量（hashtag_detail、billboard_topic_hot），从话题创建起算，是平台给的话题统计。","participant_count":"参与过这个话题的用户数（hashtag_detail），累计值。","created_at":"创建时间，格式同 posted_at。","image_count":"图文作品的图片张数（热点宝视频榜，media_type 为 image 时才有）。","like_rate":"点赞率（热点宝视频榜）：like_count ÷ play_count，小数，如 0.0118 即 1.18%。","new_follower_count":"这条作品带来的新增关注数（热点宝视频榜）。","follower_growth_rate":"涨粉率（热点宝视频榜）：平台给的小数，约等于 new_follower_count ÷ play_count。","search_trend":"这个搜索词的逐日搜索热度（billboard_search_hot）：[{date（YYYY-MM-DD）, value}]，日期从早到晚、最后一天是最近一个完整日（中国时间），最多 14 天（新上榜的词更短）；默认时间窗 1d 下最后一天的 value 等于 hot_value。","use_count":"用这段音乐发过的作品数（music_search、music_detail），即抖音音乐页上的「N 人使用」。","lyric_url":"歌词文件链接（music_search、music_detail，平台给了才有）。","rank_change":"名次变化（billboard_rise_list）：比上一次榜单快照上升了几名，负数是下降。","topic_id":"热点宝里这个热点的 ID（billboard_rise_list、billboard_challenge_hot），同一热点在不同时间的榜上相同。","category":"分类名称，取值为原平台的分类体系，未做跨平台归一。","hot_trend":"这个热点最近的热度走势（billboard_rise_list 按小时、billboard_challenge_hot 约每 10 分钟一个点）：[{time（UTC，ISO 8601）, hot_value}]，从早到晚。","total_video_count":"话题下累计作品数（billboard_topic_hot）。","daily_trend":"这个话题的逐日热度（billboard_topic_hot）：[{date（YYYY-MM-DD，中国日期）, value}]，从早到晚，最多 14 天。","time_window":"统计时间窗（xingtu_conversion_ability）：7d / 30d / 90d，与请求一致。","related_video_count":"时间窗内星图统计转化数据用到的视频数（xingtu_conversion_ability）。","video_play_median":"这些视频的播放量中位数（xingtu_conversion_ability）。","component_click_count_range":"组件点击量区间（xingtu_conversion_ability），星图给的区间写法原样给，如 500-1000、500以下。","component_click_rate_range":"组件点击率区间（xingtu_conversion_ability），如 10%以上、2%以下。","cpc_range_cny":"单次点击成本区间（CPC，xingtu_conversion_ability），人民币元，如 6-8。","gpm_range_cny":"GPM 区间（每千次播放带来的成交额，xingtu_conversion_ability），人民币元，如 10-30。","average_sales_range_cny":"平均销售额区间（xingtu_conversion_ability），人民币元，如 2000-5000；达人在星图关掉销售额展示后没有这一项。","product_count":"时间窗内带货的商品数（xingtu_conversion_ability）。","product_price_range_cny":"带货商品价格区间（xingtu_conversion_ability），人民币元。","categories":"xingtu_conversion_ability：带货品类分布 [{name 品类, share 占比（0–1）, sales_range_cny 销售额区间}]，有带货时才有；xingtu_touch_distribution：连接用户来源的内容类目，最多三层 [{name 类目, touch_count 数量, subcategories 下一层（同结构）}]。","link_type":"星图给达人的连接类型（xingtu_link_structure），中文原样给，如 传播、种草。","total_user_count":"星图连接用户总数（xingtu_link_structure），等于 levels 四档人数之和。","total_rank_top_percent":"连接用户总数在星图达人中的排名位置（xingtu_link_structure），0–1，越小越靠前：0.0456 即前 4.56%。","levels":"星图连接用户的四档（xingtu_link_structure），按星图的档位编号 1–4：[{level, user_count 人数, share 占总数比例（0–1）, industry_median_user_count 同行业达人这一档人数的中位数}]。","signature_videos":"星图主页的代表作（xingtu_recommended_videos）：[{id, url, play_count 播放量, posted_at 发布时间}]；星图这几组只给这四项。","latest_videos":"xingtu_recommended_videos：星图主页上的最新作品，字段同 signature_videos；xingtu_video_performance：最近的作品（约 15 条），另有 title、like_count、comment_count、share_count、duration_seconds、is_hot（是否热门）。","top_xingtu_order_videos":"星图商单作品里播放最高的（xingtu_recommended_videos），字段同 signature_videos；没接过商单时没有这一项。","top_personal_videos":"个人作品里播放最高的（xingtu_recommended_videos），字段同 signature_videos。","personal_videos":"个人视频的三项指标（xingtu_video_performance）：engagement_rate 互动率、play_count_median 播放量中位数、completion_rate 完播率；每项 {value 本值, platform_average 星图给的全平台平均值（各达人相同）, percentile 超过了多少比例的达人（0–1）}；统计期内没有个人作品时没有这一项。","xingtu_videos":"星图商单视频的三项指标（xingtu_video_performance），结构同 personal_videos；统计期内没有星图商单作品时没有这一项。","latest_xingtu_videos":"最近的星图商单作品（xingtu_video_performance），字段同 latest_videos。"},"undocumented":["province","industry"]}