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。