抖音

抖音 API

搜索视频、话题、音乐、达人、商品和联想词,按 secUid 查作者资料与作品,读取评论、语音文稿、热榜和热点宝榜单,查看达人画像与星图数据;作品文案不同于转写,榜单热度不跨榜混排。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 douyin,action 填下方列表里的能力名,例如 search。

  • 37 个能力
  • 每千次 $0.56 起
  • 失败和空结果都不收费
  • 24h 健康值 99%

平台运行状态

24h 健康值
99%
健康

30 天趋势

抖音 能力清单

能力做什么单价24 小时运行状态 · 全部正常
关键词搜索search按关键词搜索视频,把近期讨论与较长时间范围的内容分开看。$8.33 / 千次健康 · 健康值 100%
主页或对象详情profile用 profile 获取内容所关联的作者资料,不把抖音号、昵称与 secUid 混为一谈。$0.56 / 千次正常
用户内容user_posts用抖音用户的 secUid 读取作品列表,整理内容主题和发布时间。$0.56 / 千次健康 · 健康值 100%
视频详情video用 video 看指定作品的元数据,不把作品文案当语音全文。$0.56 / 千次健康 · 健康值 100%
评论comments用 comments 读取作品讨论,并保留能确定的父子关系。$0.56 / 千次每 20 条算一次健康 · 健康值 100%
评论回复comment_replies用 comment_replies 读取某条顶层评论下的回复,看清每条回复回的是谁,翻页取完整个楼层。$0.56 / 千次每 20 条算一次健康 · 健康值 100%
热榜trending用 boards 选择抖音榜单,按榜单来源整理选题。$0.56 / 千次健康 · 健康值 100%
视频文稿transcript给 transcript 一个具体视频链接,读取语音文稿供后续整理。$0.56 / 千次健康 · 健康值 100%
达人搜索creator_search用 creator_search 发现账号候选,再用返回的 user_id 读取资料、作品和可用的受众分析。$0.56 / 千次正常
达人粉丝画像creator_audience用 creator_audience 读取账号可得的受众分布与 TGI,用于判断内容受众是否接近目标人群。$0.56 / 千次正常
达人涨粉趋势creator_trend用 creator_trend 保存可得的粉丝趋势和平均粉丝数,为周期性复核建立指标一致的快照。$0.56 / 千次正常
同类达人对比creator_benchmark用 creator_benchmark 读取平均值与对应分位,识别需要继续人工复核的强项和短板。$0.56 / 千次正常
星图达人搜索xingtu_creator_search用 xingtu_creator_search 按创作者关键词发现候选,比较同一次查询结果内的内容、增长、报价和商业指标。$0.56 / 千次正常
星图达人分析xingtu_creator_analytics用 xingtu_creator_analytics 读取一个抖音号对应的可得星图资料,辅助人工复核候选。$0.56 / 千次正常
星图达人报价xingtu_rate_card用 xingtu_rate_card 读取一个抖音号当前可得的报价档位,保留每档的形式和结算说明。$0.56 / 千次正常
星图达人榜单xingtu_creator_rankings用 xingtu_creator_rankings 读取一个明确榜单快照,保留排名、上期名次和榜单统计范围。$0.56 / 千次正常
商品搜索product_search用 product_search 搜索商品,比较商品卡、价格、销量趋势、店铺和佣金线索。$13.33 / 千次正常
商品详情product_detail用 product_detail 按商品 ID 查看图片、规格、店铺和公开已售数据。$13.33 / 千次正常
直播商品搜索live_product_search用 live_product_search 查找当前直播商品,并保存商品与直播间标识。$0.56 / 千次正常
话题搜索hashtag_search用 hashtag_search 按关键词找名字里带这个词的抖音话题,看最近 7 天的热度和作品、点赞、播放。$15.56 / 千次正常
话题详情hashtag_detail用 hashtag_detail 按话题 ID 读这个话题从创建起的累计数据。$15.56 / 千次正常
热点宝视频热榜billboard_video_hot用 billboard_video_hot 读抖音热点宝的视频热榜:总榜、高涨粉率榜或高点赞率榜,按热度分从高到低。$0.81 / 千次正常
热点宝低粉爆款榜billboard_low_fan_explosion用 billboard_low_fan_explosion 读热点宝的低粉爆款榜,找小账号的爆款选题。$0.81 / 千次正常
热点宝高完播率榜billboard_high_completion用 billboard_high_completion 读热点宝的高完播率榜,找观众愿意看完的作品做参考。$0.81 / 千次正常
热点宝搜索热榜billboard_search_hot用 billboard_search_hot 读热点宝的搜索热榜,拿到上榜搜索词、名次和逐日搜索热度。$0.81 / 千次正常
热点宝账号搜索billboard_account_search用 billboard_account_search 按关键词找相关抖音账号,带粉丝数、获赞数和作品数。$0.81 / 千次正常
音乐搜索music_search用 music_search 搜抖音音乐库里的音乐和原声,看每段音乐有多少作品在用。$8 / 千次正常
搜索联想词search_suggest用 search_suggest 拿抖音搜索框对一个词给出的联想词,按抖音给的顺序。$8 / 千次正常
热点宝上升热点榜billboard_rise_list用 billboard_rise_list 读热点宝上升热点榜,看哪些热点正在快速上升。$0.81 / 千次正常
热点宝挑战热榜billboard_challenge_hot用 billboard_challenge_hot 一次读热点宝挑战热榜的全部 50 个挑战。$0.81 / 千次正常
热点宝话题热榜billboard_topic_hot用 billboard_topic_hot 读热点宝话题热榜,按时间窗看哪些话题在升温。$0.81 / 千次正常
音乐详情music_detail用 music_detail 按音乐 ID 读一首抖音音乐,看标题、歌手、时长和多少作品在用。$0.81 / 千次正常
星图达人转化能力xingtu_conversion_ability用 xingtu_conversion_ability 读取一个达人在近 7 / 30 / 90 天星图商单里的转化数据。$1.6 / 千次正常
星图达人连接用户结构xingtu_link_structure用 xingtu_link_structure 读取星图给达人统计的连接用户四档人数和总量排名。$16 / 千次正常
星图达人推荐视频xingtu_recommended_videos用 xingtu_recommended_videos 读取达人星图主页的四组视频:代表作、最新作品、星图商单热门、个人热门。$1.6 / 千次正常
星图达人连接用户来源xingtu_touch_distribution用 xingtu_touch_distribution 读取星图按内容类目统计的连接用户来源。$16 / 千次正常
星图达人视频表现xingtu_video_performance用 xingtu_video_performance 读取达人个人视频和星图商单视频的互动率、播放中位数、完播率,以及最近的作品。$16 / 千次正常

抖音 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价返回字段
searchkeywordpage_token, publish_time, sort默认 10 · 最多 50$8.33 / 千次next_page_token · id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_uid · author_bio · author_avatar_url · author_follower_count · cover_image_url · video_width · video_height · duration_seconds · region · hashtags · posted_at · platform · image_urls · duration_sec · hashtag_ids · search_rank · author_is_verified · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_resolution · animated_cover_url · city · city_code · location · text_language · video_bitrates · download_url · has_watermark · video_url_expires_at · permissions · author_gender · author_age
profileuser_id——$0.56 / 千次user_id · douyin_id · nickname · bio · url · follower_count · following_count · like_count · video_count · gender · ip_location · is_verified · avatar_url · uid · background_image_url · country · language · is_live · likes_given_count · has_shop · age · has_series · platform · verify_reason
user_postsuser_idpage_token, since默认 20 · 最多 100$0.56 / 千次next_page_token · id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_uid · author_bio · author_avatar_url · author_follower_count · cover_image_url · video_width · video_height · duration_seconds · region · hashtags · posted_at · platform · image_urls · duration_sec · hashtag_ids · search_rank · author_is_verified · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_resolution · animated_cover_url · city · city_code · location · text_language · video_bitrates · download_url · has_watermark · video_url_expires_at · permissions · author_gender · author_age
videourl——$0.56 / 千次id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_uid · author_bio · author_avatar_url · author_follower_count · cover_image_url · video_width · video_height · duration_seconds · region · hashtags · posted_at · platform · image_urls · duration_sec · hashtag_ids · search_rank · author_is_verified · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_resolution · animated_cover_url · city · city_code · location · text_language · video_bitrates · download_url · has_watermark · video_url_expires_at · permissions · author_gender · author_age
commentsurlpage_token默认 20 · 最多 150$0.56 / 千次每 20 条算一次next_page_token · id · text · like_count · reply_count · author_name · author_id · ip_location · is_hot · is_reply · reply_to_id · posted_at · video_id · platform · liked_by_author · author_avatar_url · author_uid · images · mentioned_users
comment_repliesurl, comment_idpage_token默认 20 · 最多 100$0.56 / 千次每 20 条算一次next_page_token · id · text · like_count · author_name · author_id · author_uid · author_avatar_url · ip_location · liked_by_author · is_reply · reply_to_id · reply_to_reply_id · reply_to_author_name · posted_at · video_id · images · mentioned_users · platform
trending—boards默认 20 · 最多 60$0.56 / 千次rank · keyword · hot_value · video_count · board · image_url · event_time · sentence_id · group_id · label · word_type · article_count · is_pinned · max_rank · live_room_count · topic_view_count · sentence_tag · label_icon_url · related_music_id · platform
transcripturl——$0.56 / 千次id · url · title · text · posted_at · play_count · like_count · comment_count · share_count · collect_count · author_name · author_avatar · author_follower_count · segments · video_url · audio_url · duration_sec · duration_seconds · recommend_count · author_like_count · platform
creator_searchkeywordfollower_range, user_type默认 20 · 最多 20$0.56 / 千次user_id · douyin_id · nickname · url · avatar_url · follower_count · gender · is_verified · verify_reason · is_live · uid · source_keyword · platform
creator_audienceuser_iddimension—$0.56 / 千次user_id · audience_distribution · audience_tgi · dimension_code · platform
creator_trenduser_id——$0.56 / 千次user_id · follower_trend · average_follower_count · dimension_code · platform
creator_benchmarkuser_id——$0.56 / 千次user_id · 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 · platform
xingtu_creator_searchkeyword—默认 20 · 最多 20$0.56 / 千次creator_id · user_id · nickname · follower_count · gender · city · province · creator_score · engagement_rate_30d · expected_play_count · expected_natural_play_count · interaction_median_30d · play_over_rate_30d · follower_growth_30d · follower_growth_rate_15d · content_themes · ecommerce_level · ecommerce_score · gmv_30d_range · gpm_30d_range · average_order_value_30d_range · commercial_index · conversion_index · spread_index · shopping_index · quote_1_20s_cny · quote_20_60s_cny · quote_60s_plus_cny · platform
xingtu_creator_analyticsdouyin_id——$0.56 / 千次creator_id · creator_type · follower_count · average_play_count · city · province · gender · category_id · content_themes · tags · creator_grade · is_xingtu_creator · ecommerce_enabled · lowest_quote_cny · platform
xingtu_rate_carddouyin_id——$0.56 / 千次creator_id · rate_tiers · platform
xingtu_creator_rankingsindustry, ranking_type, time_window—默认 5 · 最多 5$0.56 / 千次creator_id · user_id · url · nickname · avatar_url · gender · city · province · follower_count · cpm_cny · completed_order_range · repurchase_rate_range · item_order_rate · average_view_count · industry · rank · previous_rank · ranking_score · is_new · ranking_board · period_days · snapshot_date · industry_tags · primary_tag · industry_id · top_videos · source_kind · platform
product_searchkeyword—默认 5 · 最多 5$13.33 / 千次product_id · promotion_id · title · url · image_url · white_image_url · price_cny · price_cny_minor · price_label · monthly_sales · good_review_ratio · sales_trend · category_path · category_ids · category_depth · shop_id · shop_name · shop_logo_url · shop_score · commission_rate_percent · commission_cny · cooperating_creator_count · tags · source_keyword · search_rank · recommend_reason · platform
product_detailproduct_id——$13.33 / 千次product_id · title · price_cny · discount_price_cny · sales_text · sold_count · shop_id · shop_name · shop_avatar_url · image_url · main_image_urls · detail_image_urls · assurances · shipping_fee_text · shipping_estimate_text · variant_groups · on_sale · platform
live_product_searchkeyword—默认 3 · 最多 3$0.56 / 千次product_id · sku_id · title · image_url · price_cny · shop_id · live_room_id · is_live_product · source_keyword · platform
hashtag_searchkeyword—默认 20 · 最多 200$15.56 / 千次hashtag_id · hashtag_name · search_rank · heat_index · period_video_count · period_like_count · period_view_count · period_start · period_end · platform
hashtag_detailhashtag_id——$15.56 / 千次hashtag_id · hashtag_name · total_view_count · participant_count · created_at · url · platform
billboard_video_hot—board, keyword, page_token, time_window每页 50 条$0.81 / 千次id · url · text · media_type · image_count · cover_image_url · video_url · duration_seconds · duration_sec · author_name · author_avatar_url · author_follower_count · play_count · like_count · like_rate · new_follower_count · follower_growth_rate · hot_value · posted_at · next_page_token · platform
billboard_low_fan_explosion—keyword, page_token, time_window每页 50 条$0.81 / 千次id · url · text · media_type · image_count · cover_image_url · video_url · duration_seconds · duration_sec · author_name · author_avatar_url · author_follower_count · play_count · like_count · like_rate · new_follower_count · follower_growth_rate · hot_value · posted_at · next_page_token · platform
billboard_high_completion—keyword, page_token, time_window每页 50 条$0.81 / 千次id · url · text · media_type · image_count · cover_image_url · video_url · duration_seconds · duration_sec · author_name · author_avatar_url · author_follower_count · play_count · like_count · like_rate · new_follower_count · follower_growth_rate · hot_value · posted_at · next_page_token · platform
billboard_search_hot—keyword, page_token, time_window每页 50 条$0.81 / 千次rank · keyword · hot_value · search_trend · platform
billboard_account_searchkeywordpage_token每页 30 条$0.81 / 千次user_id · nickname · url · avatar_url · follower_count · like_count · video_count · next_page_token · platform
music_searchkeywordpage_token每页 10 条$8 / 千次id · url · title · author_name · duration_seconds · duration_sec · use_count · cover_image_url · audio_url · lyric_url · tags · next_page_token · platform
search_suggestkeyword—默认 10 · 最多 10$8 / 千次rank · keyword · platform
billboard_rise_list—keyword, page_token每页 50 条$0.81 / 千次rank · rank_change · title · topic_id · hot_value · video_count · category · created_at · hot_trend · next_page_token · platform
billboard_challenge_hot——默认 50 · 最多 50$0.81 / 千次rank · title · topic_id · hot_value · video_count · created_at · hot_trend · platform
billboard_topic_hot—keyword, page_token, time_window每页 50 条$0.81 / 千次rank · hashtag_id · hashtag_name · hot_value · total_view_count · total_video_count · average_view_count · cover_image_url · created_at · daily_trend · next_page_token · platform
music_detailmusic_id——$0.81 / 千次id · url · title · author_name · duration_seconds · duration_sec · use_count · cover_image_url · audio_url · lyric_url · platform
xingtu_conversion_abilitydouyin_idtime_window—$1.6 / 千次creator_id · time_window · related_video_count · video_play_median · component_click_count_range · component_click_rate_range · cpc_range_cny · gpm_range_cny · average_sales_range_cny · product_count · product_price_range_cny · categories · platform
xingtu_link_structuredouyin_id——$16 / 千次creator_id · link_type · total_user_count · total_rank_top_percent · levels · platform
xingtu_recommended_videosdouyin_id——$1.6 / 千次creator_id · signature_videos · latest_videos · top_xingtu_order_videos · top_personal_videos · platform
xingtu_touch_distributiondouyin_id——$16 / 千次creator_id · categories · platform
xingtu_video_performancedouyin_id——$16 / 千次creator_id · personal_videos · xingtu_videos · latest_videos · latest_xingtu_videos · platform

怎么调用 抖音 主页或对象详情 API?

profile

使用 platform="douyin"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 user_id、douyin_id、nickname、bio、url、follower_count 等 24 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 profile 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),用于读取账号资料;该动作不接受 since 筛选账号。

抖音开放平台将 Open ID 定义为当前应用内的用户标识,Union ID 则属于开发者账号范围。本页 user_id 按上方说明填写 secUid,不把开放平台的标识直接当作同一种输入。官方来源:抖音开放平台:Open ID 与 Union ID来源核查:

抖音 返回字段与含义(13)
douyin_id
抖音号(用户自定义的可搜索 ID)。
nickname
昵称。
gender
性别。
ip_location
IP 属地(平台强制展示,非用户填写)。
video_count
视频数:profile、billboard_account_search 是账号的作品数,trending、billboard_rise_list、billboard_challenge_hot 是这个热点下的相关视频数。
is_live
账号在采集时是否正在直播;属于时点状态。
uid
数字用户 ID(profile / creator_search);user_id 是 secUid,两者是同一账号的两种 ID。
verify_reason
认证说明原文(profile / creator_search),企业认证或个人认证的文字;未认证的账号为空或没有这个字段。
background_image_url
主页背景图链接。
likes_given_count
主页公开的「喜欢」数(该账号点过赞的作品数)。
has_shop
账号是否开通商品橱窗。
age
账号主人年龄(profile;公开了才有)。
has_series
账号是否开通了合集/系列(profile)。

怎么调用 抖音 用户内容 API?

user_posts

使用 platform="douyin"、action="user_posts" 调用“用户内容”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 next_page_token、id、url、text、media_type、video_url 等 55 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 user_posts 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。

抖音开放平台将 Open ID 定义为当前应用内的用户标识,Union ID 则属于开发者账号范围。本页 user_id 按上方说明填写 secUid,不把开放平台的标识直接当作同一种输入。官方来源:抖音开放平台:Open ID 与 Union ID来源核查:

page_token可选
翻页令牌(user_posts / comments)。从第一页开始翻:传空字符串 page_token="";之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数保持不变。令牌 24 小时内有效,只能在同一账户、同一组参数下使用,过期或参数变了返回 422,从第一页重新开始即可;翻到底时响应里没有 next_page_token(pagination.has_more 为 false)。user_posts 每页算一次调用,每页最多 100 条、最新优先,翻页时不按 since 过滤(需要时间窗请按 posted_at 自行过滤)。comments 每页最多 50 条顶层评论,按条数分档计费:每 20 条算一次,一页按 50 条算 3 次(传更小的 limit 按 limit 算),一条都没返回的档不扣费。不带 page_token 是单次调用:user_posts 取最新一批(可用 since);comments 只读头部评论(含回复,同样每 20 条算一次),默认 20 条,limit 再大最多也只有约 50-60 条,一般没有 next_page_token。
since可选
频道视频的最早发布日期,格式 YYYY-MM-DD;只用于 user_posts 列表,不是账号创建日期。
抖音 返回字段与含义(39)
author_douyin_id
作者抖音号。
region
地区。
view_count
播放量。抖音不对外公开播放量:多数结果没有这个字段,有时为 0,都不代表真实播放;判断视频热度请用 like_count(点赞)、comment_count、share_count。
media_type
媒体类型。
search_rank
在这次关键词搜索结果里的名次(从 1 开始):product_search 行是商品,search 行是作品,hashtag_search 行是话题。
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
video_url
视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
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 属地(平台强制展示)。
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
动态封面链接。
duration_sec
视频时长(秒)。
hashtag_ids
作品话题 ID 列表,与 hashtags 同序一一对应(search / user_posts / video)。
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
作者年龄(作者公开了才有)。

怎么调用 抖音 视频详情 API?

video

使用 platform="douyin"、action="video" 调用“视频详情”能力;返回单个对象,主要包含 id、url、text、media_type、video_url、like_count 等 54 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 video 的参数分别是什么意思?

url必填
目标抖音视频的完整链接,格式如 https://www.douyin.com/video/<视频ID>。video 读取该视频详情,comments 读取其评论,transcript 提取该视频的语音文稿;不要传用户主页或搜索页。

官方说明 PC 端视频播放 URL 可用于取得 VideoID,并可按 VideoID 获取播放器信息;这里只支撑 EveryInfra 将视频 URL 规范化为标识的对象语义,不证明任意公开视频都可读取、无需授权或本接口全部字段均由该官方接口提供。官方来源:抖音开放平台:视频播放 URL 与 VideoID来源核查:

抖音 返回字段与含义(38)
author_douyin_id
作者抖音号。
region
地区。
view_count
播放量。抖音不对外公开播放量:多数结果没有这个字段,有时为 0,都不代表真实播放;判断视频热度请用 like_count(点赞)、comment_count、share_count。
media_type
媒体类型。
search_rank
在这次关键词搜索结果里的名次(从 1 开始):product_search 行是商品,search 行是作品,hashtag_search 行是话题。
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
video_url
视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
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 属地(平台强制展示)。
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
动态封面链接。
duration_sec
视频时长(秒)。
hashtag_ids
作品话题 ID 列表,与 hashtags 同序一一对应(search / user_posts / video)。
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
作者年龄(作者公开了才有)。

怎么调用 抖音 评论 API?

comments

使用 platform="douyin"、action="comments" 调用“评论”能力;返回列表,默认 20 条、单次最多 150 条,主要包含 next_page_token、id、text、like_count、reply_count、author_name 等 19 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 comments 的参数分别是什么意思?

url必填
目标抖音视频的完整链接,格式如 https://www.douyin.com/video/<视频ID>。video 读取该视频详情,comments 读取其评论,transcript 提取该视频的语音文稿;不要传用户主页或搜索页。

官方评论接口以 item_id 查询视频评论,单次 count 最大 50;EveryInfra 的 url 到视频标识转换属于自身实现,该来源不能证明任意公开视频、全部评论、无需授权或本接口的结果上限。官方来源:抖音开放平台:按视频标识读取评论列表来源核查:

page_token可选
翻页令牌(user_posts / comments)。从第一页开始翻:传空字符串 page_token="";之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数保持不变。令牌 24 小时内有效,只能在同一账户、同一组参数下使用,过期或参数变了返回 422,从第一页重新开始即可;翻到底时响应里没有 next_page_token(pagination.has_more 为 false)。user_posts 每页算一次调用,每页最多 100 条、最新优先,翻页时不按 since 过滤(需要时间窗请按 posted_at 自行过滤)。comments 每页最多 50 条顶层评论,按条数分档计费:每 20 条算一次,一页按 50 条算 3 次(传更小的 limit 按 limit 算),一条都没返回的档不扣费。不带 page_token 是单次调用:user_posts 取最新一批(可用 since);comments 只读头部评论(含回复,同样每 20 条算一次),默认 20 条,limit 再大最多也只有约 50-60 条,一般没有 next_page_token。
抖音 返回字段与含义(10)
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
author_uid
作者(评论里是评论者)的数字用户 ID;author_id 是 secUid,两者是同一个人的两种 ID。
ip_location
IP 属地(平台强制展示,非用户填写)。
is_reply
是否为回复。
reply_to_id
被回复评论 ID:comments 的回复行上是它挂在哪条顶层评论下;comment_replies 每行都是请求的那条顶层评论。
liked_by_author
评论是否被作者点赞。作者亲自点赞的评论互动价值高。
is_hot
该评论是否带「热评」标记(comments)。
video_id
评论所属视频 ID(comments)。
mentioned_users
评论里 @ 到的人:user_id(secUid)、uid(数字 ID)、nickname;没有 @ 时没有这个键。

怎么调用 抖音 评论回复 API?

comment_replies

使用 platform="douyin"、action="comment_replies" 调用“评论回复”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 next_page_token、id、text、like_count、author_name、author_id 等 19 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 comment_replies 的参数分别是什么意思?

url必填
评论所在的抖音视频链接(https://www.douyin.com/video/<视频ID>)或纯数字视频 ID,和取这条评论时 comments 用的是同一个视频。
comment_id必填
要取回复的那条顶层评论的 ID(纯数字),取自 comments 返回的 id;reply_count 大于 0 的评论才有回复。
page_token可选
翻页令牌。第一页传空字符串 page_token="",之后把上一页响应里的 next_page_token 原样传回,其余参数不变;每页最多 20 条回复,按条数分档计费(每 20 条算一次,一条都没返回不扣费)。令牌 24 小时内有效,只能在同一账户、同一组参数下使用;翻到底时响应里没有 next_page_token。
抖音 返回字段与含义(11)
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
author_uid
作者(评论里是评论者)的数字用户 ID;author_id 是 secUid,两者是同一个人的两种 ID。
ip_location
IP 属地(平台强制展示,非用户填写)。
is_reply
是否为回复。
reply_to_id
被回复评论 ID:comments 的回复行上是它挂在哪条顶层评论下;comment_replies 每行都是请求的那条顶层评论。
liked_by_author
评论是否被作者点赞。作者亲自点赞的评论互动价值高。
video_id
评论所属视频 ID(comments)。
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)。

怎么调用 抖音 视频文稿 API?

transcript

使用 platform="douyin"、action="transcript" 调用“视频文稿”能力;返回单个对象,主要包含 id、url、title、text、posted_at、play_count 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 transcript 的参数分别是什么意思?

url必填
目标抖音视频的完整链接,格式如 https://www.douyin.com/video/<视频ID>。video 读取该视频详情,comments 读取其评论,transcript 提取该视频的语音文稿;不要传用户主页或搜索页。
抖音 返回字段与含义(8)
video_url
视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
author_like_count
作者主页获赞总数(search / user_posts / video / transcript)。
duration_sec
视频时长(秒)。
author_avatar
作者头像。
play_count
播放量。热点宝榜单(billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion)上是平台统计的播放数;其余能力上抖音不对外公开播放量,这里的值(多为 0)不代表真实播放,热度判断请用点赞/评论/分享数。
segments
转写的逐句时间轴(transcript):每句带 start、end(秒)和 text。
audio_url
音频地址:transcript 是视频音轨(mp3),music_search、music_detail 是这段音乐的播放地址;可能会过期。
recommend_count
作品的推荐数(transcript)。

怎么调用 抖音 达人粉丝画像 API?

creator_audience

使用 platform="douyin"、action="creator_audience" 调用“达人粉丝画像”能力;返回单个对象,主要包含 user_id、audience_distribution、audience_tgi、dimension_code、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台的可读 OpenAPI 文档列出年龄、设备、性别、地域、兴趣和流量贡献等粉丝分布,并明确需要申请权限、用户授权及账号规模条件。它不证明 EveryInfra 可枚举逐个粉丝,也不能把粉丝分布写成视频观众、商品买家或成交用户画像。官方来源:抖音开放平台:授权账号的粉丝画像维度来源核查:

抖音 creator_audience 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。
dimension可选
达人粉丝画像维度:device_price_band 设备价格带(默认)、gender 性别、age 年龄、province 省份。
查看全部 4 个允许值

agedevice_price_bandgenderprovince

抖音 返回字段与含义(3)
audience_distribution
粉丝受众分布桶;value 是 0–1 的份额小数,不是百分数、人数或实际买家占比。
audience_tgi
受众桶相对平台平均的 TGI 指数;与份额 value 是独立量纲,不是人数或成交占比。
dimension_code
画像维度:device_price_band、gender、age 或 province;由请求 option 映射,不把领先分布桶标签当维度。

怎么调用 抖音 达人涨粉趋势 API?

creator_trend

使用 platform="douyin"、action="creator_trend" 调用“达人涨粉趋势”能力;返回单个对象,主要包含 user_id、follower_trend、average_follower_count、dimension_code、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

巨量星图客户移动端指南将播放趋势、粉丝趋势和粉丝分布列为达人页面资料。该来源只支撑趋势对象及投前复核场景,不定义 EveryInfra 的 dimension_code、采样窗口、时间点完整性或变化原因。官方来源:巨量星图:达人主页的播放趋势与粉丝趋势来源核查:

抖音 creator_trend 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。
抖音 返回字段与含义(3)
dimension_code
画像维度:device_price_band、gender、age 或 province;由请求 option 映射,不把领先分布桶标签当维度。
follower_trend
粉丝数量随日期变化的序列。
average_follower_count
趋势窗口内的平均粉丝量。

怎么调用 抖音 同类达人对比 API?

creator_benchmark

使用 platform="douyin"、action="creator_benchmark" 调用“同类达人对比”能力;返回单个对象,主要包含 user_id、average_post_count、average_comment_count、average_share_count、average_follower_growth、average_like_count 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

巨量星图指南列出传播、性价比、涨粉、合作、种草等指数,以及任务数、预期播放和 CPM 性价比等重点数据。它不定义 EveryInfra 的平均值或 percentile 算法,也不证明分位是官方排名、同行全量样本或未来效果保证。官方来源:巨量星图:达人指数与重点数据用于候选评估来源核查:

抖音 creator_benchmark 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。
抖音 返回字段与含义(10)
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
点赞量在同类账号中的百分位。

怎么调用 抖音 星图达人分析 API?

xingtu_creator_analytics

使用 platform="douyin"、action="xingtu_creator_analytics" 调用“星图达人分析”能力;返回单个对象,主要包含 creator_id、creator_type、follower_count、average_play_count、city、province 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

巨量星图达人广场指南说明客户会从商业能力、创作能力和履约能力筛选达人,并列出播放量中位数、完播率、互动率、预期播放、预期 CPM、内容主题及转化能力等投前语境。该来源不定义 EveryInfra 的 douyin_id 输入、字段全集、匿名访问、更新频率或数据完整性,也不把平台指标变成合作效果保证。官方来源:巨量星图:达人广场的商业、创作与履约分析维度来源核查:

抖音 xingtu_creator_analytics 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id),从普通 creator_search 结果取得;不是 secUid、昵称或星图 ID。
抖音 返回字段与含义(11)
city
城市:作品行(search / user_posts / video)是作品发布城市,平台给的是拼音写法(如 Suzhou);xingtu_creator_rankings 是达人所在城市。
gender
性别。
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
content_themes
平台给达人标记的内容主题标签。
lowest_quote_cny
星图展示的最低合作报价;单位未经核实,请勿直接用于报价。是报价,不是成交价。
creator_type
星图返回的达人类型。
average_play_count
星图返回的平均播放量。
category_id
星图达人分类 ID。
creator_grade
星图达人等级。
is_xingtu_creator
是否为星图达人。
ecommerce_enabled
是否具备星图电商能力标记。

怎么调用 抖音 星图达人报价 API?

xingtu_rate_card

使用 platform="douyin"、action="xingtu_rate_card" 调用“星图达人报价”能力;返回单个对象,主要包含 creator_id、rate_tiers、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

巨量星图报价指南说明报价会按任务类型与视频时长设置,修改可能立即或次月生效,平台建议报价也会随账号的内容、增长、互动和转化能力评估而变化。该来源只支撑报价是分档、可变的当前状态,不证明 EveryInfra 返回全部任务报价、最终合同价、结算结果或达人必然接单。官方来源:巨量星图:达人报价档位与生效边界来源核查:

抖音 xingtu_rate_card 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id),从普通 creator_search 结果取得;不是 secUid、昵称或星图 ID。
抖音 返回字段与含义(2)
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
rate_tiers
星图报价档位;每档保留形式说明、实际报价(price_cny)、原报价(list_price_cny)、结算说明、视频类型与开放状态;报价单位是人民币元。

怎么调用 抖音 星图达人榜单 API?

xingtu_creator_rankings

使用 platform="douyin"、action="xingtu_creator_rankings" 调用“星图达人榜单”能力;返回列表,默认 5 条、单次最多 5 条,主要包含 creator_id、user_id、url、nickname、avatar_url、gender 等 28 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

巨量星图榜单指南区分内容价值榜与商业价值榜,并说明可按营销目标或主播类型、榜单类型和时间范围查看;排名可能使用商单数、复购率、播放量、CPM、CTR、CVR、GPM 等不同指标。该来源不定义 EveryInfra 的英文枚举、5 条上限、字段全集、榜单覆盖或刷新频率,也不能把榜单名次写成合作推荐。官方来源:巨量星图:达人榜单类型、时间范围与排名规则来源核查:

抖音 xingtu_creator_rankings 的参数分别是什么意思?

industry必填
星图商业达人榜的行业:beauty、electronics、food_beverage、apparel_accessories、automotive、mother_baby_pets、household_goods。
查看全部 7 个允许值

apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets

ranking_type必填
星图榜单类型:top_creators、rising_stars、sales_champions、viral_drivers、paid_ad_performers、head_tier 或 all_top。
查看全部 7 个允许值

all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers

time_window必填
榜单时间窗:latest_weekly、latest_monthly、all_history_weekly 或 all_history_monthly。
查看全部 4 个允许值

all_history_monthlyall_history_weeklylatest_monthlylatest_weekly

抖音 返回字段与含义(21)
city
城市:作品行(search / user_posts / video)是作品发布城市,平台给的是拼音写法(如 Suzhou);xingtu_creator_rankings 是达人所在城市。
nickname
昵称。
gender
性别。
rank
名次(从 1 开始):trending 是热榜排名,xingtu_creator_rankings 是星图榜单里的名次,billboard_search_hot 是搜索热榜名次,search_suggest 是联想词在抖音搜索框里的顺序;billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次(翻页接着往下数)。
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
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。
source_kind
数据来源类型;目前只接受并返回 ranking。
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(播放数)}]。

怎么调用 抖音 商品详情 API?

product_detail

使用 platform="douyin"、action="product_detail" 调用“商品详情”能力;返回单个对象,主要包含 product_id、title、price_cny、discount_price_cny、sales_text、sold_count 等 18 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 product_detail 的参数分别是什么意思?

product_id必填
抖音商城商品数字 ID;从 product_search 或 live_product_search 结果取得,不是 SKU ID、推广 ID 或商品标题。
抖音 返回字段与含义(15)
product_id
抖音商城商品稳定 ID。
price_cny
商品展示价格,人民币元。
shop_id
抖音商城店铺 ID。
shop_name
抖音商城店铺名称。
discount_price_cny
商品当前公开优惠价,人民币元;缺失时不从原价推算。
sold_count
商品详情当前公开的已售数量;是采集时快照,不等于指定达人销量。
sales_text
商品详情公开销量原文。
shop_avatar_url
抖音商城店铺头像 URL。
main_image_urls
商品头图/轮播图 URL 列表。
detail_image_urls
商品详情长图 URL 列表。
assurances
商品公开服务保障标签。
shipping_fee_text
商品公开运费或发货地说明原文。
shipping_estimate_text
商品公开预计发货说明原文。
variant_groups
商品规格组与可选项;只保留规格名、选项名和公开规格 ID。
on_sale
商品在采集时是否显示在售。

怎么调用 抖音 话题详情 API?

hashtag_detail

使用 platform="douyin"、action="hashtag_detail" 调用“话题详情”能力;返回单个对象,主要包含 hashtag_id、hashtag_name、total_view_count、participant_count、created_at、url 等 7 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 hashtag_detail 的参数分别是什么意思?

hashtag_id必填
话题 ID,纯数字(例如 1767586897793101),取自 hashtag_search 返回行的 hashtag_id;不是话题名。
抖音 返回字段与含义(4)
hashtag_id
话题 ID(纯数字字符串);作为 hashtag_detail 的 hashtag_id 传回可读这个话题的累计数据。
hashtag_name
话题名,不带 #。
total_view_count
话题累计播放量(hashtag_detail、billboard_topic_hot),从话题创建起算,是平台给的话题统计。
participant_count
参与过这个话题的用户数(hashtag_detail),累计值。

怎么调用 抖音 热点宝视频热榜 API?

billboard_video_hot

使用 platform="douyin"、action="billboard_video_hot" 调用“热点宝视频热榜”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 id、url、text、media_type、image_count、cover_image_url 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

抖音 billboard_video_hot 的参数分别是什么意思?

board可选
榜单:all 总榜(默认)/ follower_growth 高涨粉率榜 / like_rate 高点赞率榜。
查看全部 3 个允许值

allfollower_growthlike_rate

keyword可选
只看和这个关键词相关的作品(可选),例如 美食;不传是全站榜单。
page_token可选
翻页令牌。不传是第 1 页;之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。每页最多 50 条、算一次调用:抖音会滤掉一部分作品,一页常常不到 50 条,不代表到底;令牌 24 小时内有效;翻到底时没有 next_page_token(每个榜单最多约 1000 条)。
time_window可选
统计时间窗:1h 最近 1 小时 / 1d 最近 24 小时(默认)/ 3d 最近 3 天 / 7d 最近 7 天。
查看全部 4 个允许值

1d1h3d7d

抖音 返回字段与含义(12)
media_type
媒体类型。
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
video_url
视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
duration_sec
视频时长(秒)。
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
play_count
播放量。热点宝榜单(billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion)上是平台统计的播放数;其余能力上抖音不对外公开播放量,这里的值(多为 0)不代表真实播放,热度判断请用点赞/评论/分享数。
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。

怎么调用 抖音 热点宝低粉爆款榜 API?

billboard_low_fan_explosion

使用 platform="douyin"、action="billboard_low_fan_explosion" 调用“热点宝低粉爆款榜”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 id、url、text、media_type、image_count、cover_image_url 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

抖音 billboard_low_fan_explosion 的参数分别是什么意思?

keyword可选
只看和这个关键词相关的作品(可选),例如 美食;不传是全站榜单。
page_token可选
翻页令牌。不传是第 1 页;之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。每页最多 50 条、算一次调用:抖音会滤掉一部分作品,一页常常不到 50 条,不代表到底;令牌 24 小时内有效;翻到底时没有 next_page_token(每个榜单最多约 1000 条)。
time_window可选
统计时间窗:1h 最近 1 小时 / 1d 最近 24 小时(默认)/ 3d 最近 3 天 / 7d 最近 7 天。
查看全部 4 个允许值

1d1h3d7d

抖音 返回字段与含义(12)
media_type
媒体类型。
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
video_url
视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
duration_sec
视频时长(秒)。
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
play_count
播放量。热点宝榜单(billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion)上是平台统计的播放数;其余能力上抖音不对外公开播放量,这里的值(多为 0)不代表真实播放,热度判断请用点赞/评论/分享数。
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。

怎么调用 抖音 热点宝高完播率榜 API?

billboard_high_completion

使用 platform="douyin"、action="billboard_high_completion" 调用“热点宝高完播率榜”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 id、url、text、media_type、image_count、cover_image_url 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

抖音 billboard_high_completion 的参数分别是什么意思?

keyword可选
只看和这个关键词相关的作品(可选),例如 美食;不传是全站榜单。
page_token可选
翻页令牌。不传是第 1 页;之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。每页最多 50 条、算一次调用:抖音会滤掉一部分作品,一页常常不到 50 条,不代表到底;令牌 24 小时内有效;翻到底时没有 next_page_token(每个榜单最多约 1000 条)。
time_window可选
统计时间窗:1h 最近 1 小时 / 1d 最近 24 小时(默认)/ 3d 最近 3 天 / 7d 最近 7 天。
查看全部 4 个允许值

1d1h3d7d

抖音 返回字段与含义(12)
media_type
媒体类型。
author_avatar_url
作者头像链接:search / user_posts / video 行上是博主的,comments 行上是评论者的。
video_url
视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
duration_sec
视频时长(秒)。
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
play_count
播放量。热点宝榜单(billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion)上是平台统计的播放数;其余能力上抖音不对外公开播放量,这里的值(多为 0)不代表真实播放,热度判断请用点赞/评论/分享数。
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。

怎么调用 抖音 热点宝搜索热榜 API?

billboard_search_hot

使用 platform="douyin"、action="billboard_search_hot" 调用“热点宝搜索热榜”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 rank、keyword、hot_value、search_trend、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

抖音 billboard_search_hot 的参数分别是什么意思?

keyword可选
只看含这个词的搜索词(可选),例如 美食;不传是全站搜索热榜。
page_token可选
翻页令牌。不传是第 1 页(前 50 个词);之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。每页最多 50 个词、算一次调用;令牌 24 小时内有效;翻到底时没有 next_page_token。
time_window可选
统计时间窗:1h 最近 1 小时 / 1d 最近 24 小时(默认)/ 3d 最近 3 天 / 7d 最近 7 天。
查看全部 4 个允许值

1d1h3d7d

抖音 返回字段与含义(4)
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
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 是抖音给出的联想搜索词。
search_trend
这个搜索词的逐日搜索热度(billboard_search_hot):[{date(YYYY-MM-DD), value}],日期从早到晚、最后一天是最近一个完整日(中国时间),最多 14 天(新上榜的词更短);默认时间窗 1d 下最后一天的 value 等于 hot_value。

怎么调用 抖音 搜索联想词 API?

search_suggest

使用 platform="douyin"、action="search_suggest" 调用“搜索联想词”能力;返回列表,默认 10 条、单次最多 10 条,主要包含 rank、keyword、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 search_suggest 的参数分别是什么意思?

keyword必填
搜索框里输入的词,例如 人工智能;返回抖音搜索框给出的联想词,按抖音给的顺序。
抖音 返回字段与含义(2)
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 是抖音给出的联想搜索词。

怎么调用 抖音 热点宝上升热点榜 API?

billboard_rise_list

使用 platform="douyin"、action="billboard_rise_list" 调用“热点宝上升热点榜”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 rank、rank_change、title、topic_id、hot_value、video_count 等 11 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

抖音 billboard_rise_list 的参数分别是什么意思?

keyword可选
只看含这个词的热点(可选),例如 游戏;不传是全站上升热点榜。
page_token可选
翻页令牌。不传是第 1 页(前 50 个热点);之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。每页最多 50 个、算一次调用;令牌 24 小时内有效;翻到底时没有 next_page_token。
抖音 返回字段与含义(7)
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
video_count
视频数:profile、billboard_account_search 是账号的作品数,trending、billboard_rise_list、billboard_challenge_hot 是这个热点下的相关视频数。
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
rank
名次(从 1 开始):trending 是热榜排名,xingtu_creator_rankings 是星图榜单里的名次,billboard_search_hot 是搜索热榜名次,search_suggest 是联想词在抖音搜索框里的顺序;billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次(翻页接着往下数)。
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}],从早到晚。

怎么调用 抖音 热点宝挑战热榜 API?

billboard_challenge_hot

使用 platform="douyin"、action="billboard_challenge_hot" 调用“热点宝挑战热榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、title、topic_id、hot_value、video_count、created_at 等 8 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

这个能力没有业务参数,只传 platform 与 action。

抖音 返回字段与含义(5)
video_count
视频数:profile、billboard_account_search 是账号的作品数,trending、billboard_rise_list、billboard_challenge_hot 是这个热点下的相关视频数。
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
rank
名次(从 1 开始):trending 是热榜排名,xingtu_creator_rankings 是星图榜单里的名次,billboard_search_hot 是搜索热榜名次,search_suggest 是联想词在抖音搜索框里的顺序;billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次(翻页接着往下数)。
topic_id
热点宝里这个热点的 ID(billboard_rise_list、billboard_challenge_hot),同一热点在不同时间的榜上相同。
hot_trend
这个热点最近的热度走势(billboard_rise_list 按小时、billboard_challenge_hot 约每 10 分钟一个点):[{time(UTC,ISO 8601), hot_value}],从早到晚。

怎么调用 抖音 热点宝话题热榜 API?

billboard_topic_hot

使用 platform="douyin"、action="billboard_topic_hot" 调用“热点宝话题热榜”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 rank、hashtag_id、hashtag_name、hot_value、total_view_count、total_video_count 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音开放平台服务市场的条目说明「生活服务热点中心」(原「抖音热点宝」)由北京抖音科技有限公司提供,是抖音官方的热点数据分析工具,用来解读热点趋势、帮助创作者选题。这里只核对这些榜单出自抖音官方的热点宝;该条目没有列出各榜单的排序口径、涨粉率与点赞率的算法、每页条数或榜单长度,这些以本页说明为准。官方来源:抖音开放平台:热点宝是抖音官方的热点数据工具来源核查:

抖音 billboard_topic_hot 的参数分别是什么意思?

keyword可选
只看名字里含这个词的话题(可选),例如 美食;不传是全站话题热榜。
page_token可选
翻页令牌。不传是第 1 页(前 50 个话题);之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。每页最多 50 个、算一次调用;令牌 24 小时内有效;翻到底时没有 next_page_token(每个榜最多约 1000 个)。
time_window可选
统计时间窗:1h 最近 1 小时 / 1d 最近 24 小时(默认)/ 3d 最近 3 天 / 7d 最近 7 天。
查看全部 4 个允许值

1d1h3d7d

抖音 返回字段与含义(10)
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
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。没有该字段即到底。评论翻页逐页覆盖全部顶层评论。
hot_value
热度值,抖音自有指标,只在同一榜单、同一时间窗内可比:trending 是热榜热度(热点榜 hotspot 的行上常常为空);热点宝视频榜(billboard_video_hot 等)是榜单热度分,行按它从高到低排;billboard_search_hot 是这个词在时间窗里的搜索热度;billboard_rise_list、billboard_challenge_hot 是热点热度,billboard_topic_hot 是话题在时间窗里的热度分。
rank
名次(从 1 开始):trending 是热榜排名,xingtu_creator_rankings 是星图榜单里的名次,billboard_search_hot 是搜索热榜名次,search_suggest 是联想词在抖音搜索框里的顺序;billboard_rise_list、billboard_challenge_hot、billboard_topic_hot 是热点宝榜单名次(翻页接着往下数)。
average_view_count
榜单快照内的平均视频播放量;话题榜(billboard_topic_hot)是话题下作品的平均播放量。
hashtag_id
话题 ID(纯数字字符串);作为 hashtag_detail 的 hashtag_id 传回可读这个话题的累计数据。
hashtag_name
话题名,不带 #。
total_view_count
话题累计播放量(hashtag_detail、billboard_topic_hot),从话题创建起算,是平台给的话题统计。
daily_trend
这个话题的逐日热度(billboard_topic_hot):[{date(YYYY-MM-DD,中国日期), value}],从早到晚,最多 14 天。
total_video_count
话题下累计作品数(billboard_topic_hot)。

怎么调用 抖音 音乐详情 API?

music_detail

使用 platform="douyin"、action="music_detail" 调用“音乐详情”能力;返回单个对象,主要包含 id、url、title、author_name、duration_seconds、duration_sec 等 11 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 music_detail 的参数分别是什么意思?

music_id必填
抖音音乐 ID,纯数字(如 7699717253151558410),取自 music_search 返回行的 id;也收 douyin.com/music/<ID> 链接。
抖音 返回字段与含义(5)
cover_image_url
封面图链接:search / user_posts 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图。
duration_sec
视频时长(秒)。
audio_url
音频地址:transcript 是视频音轨(mp3),music_search、music_detail 是这段音乐的播放地址;可能会过期。
use_count
用这段音乐发过的作品数(music_search、music_detail),即抖音音乐页上的「N 人使用」。
lyric_url
歌词文件链接(music_search、music_detail,平台给了才有)。

怎么调用 抖音 星图达人转化能力 API?

xingtu_conversion_ability

使用 platform="douyin"、action="xingtu_conversion_ability" 调用“星图达人转化能力”能力;返回单个对象,主要包含 creator_id、time_window、related_video_count、video_play_median、component_click_count_range、component_click_rate_range 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 xingtu_conversion_ability 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id);也可以直接填星图达人 ID(19 位数字,即 xingtu_creator_search 返回的 creator_id)。不是星图达人时返回空结果、不扣费。
time_window可选
统计时间窗:7d 近 7 天 / 30d 近 30 天(默认)/ 90d 近 90 天。
查看全部 3 个允许值

30d7d90d

抖音 返回字段与含义(12)
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
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 下一层(同结构)}]。

怎么调用 抖音 星图达人连接用户来源 API?

xingtu_touch_distribution

使用 platform="douyin"、action="xingtu_touch_distribution" 调用“星图达人连接用户来源”能力;返回单个对象,主要包含 creator_id、categories、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

抖音 xingtu_touch_distribution 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id);也可以直接填星图达人 ID(19 位数字,即 xingtu_creator_search 返回的 creator_id)。不是星图达人时返回空结果、不扣费。
抖音 返回字段与含义(2)
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
categories
xingtu_conversion_ability:带货品类分布 [{name 品类, share 占比(0–1), sales_range_cny 销售额区间}],有带货时才有;xingtu_touch_distribution:连接用户来源的内容类目,最多三层 [{name 类目, touch_count 数量, subcategories 下一层(同结构)}]。

怎么调用 抖音 星图达人视频表现 API?

xingtu_video_performance

使用 platform="douyin"、action="xingtu_video_performance" 调用“星图达人视频表现”能力;返回单个对象,主要包含 creator_id、personal_videos、xingtu_videos、latest_videos、latest_xingtu_videos、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

巨量星图达人广场指南说明可以查看达人个人视频、星图视频的播放量中位数、完播率、互动率等指标,看达人内容表现处于什么水位。该来源不定义 EveryInfra 的 platform_average、percentile 字段、统计周期或最近作品条数,也不把这些指标变成合作效果保证。官方来源:巨量星图:达人个人视频与星图视频的内容表现指标来源核查:

抖音 xingtu_video_performance 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id);也可以直接填星图达人 ID(19 位数字,即 xingtu_creator_search 返回的 creator_id)。不是星图达人时返回空结果、不扣费。
抖音 返回字段与含义(5)
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
latest_videos
xingtu_recommended_videos:星图主页上的最新作品,字段同 signature_videos;xingtu_video_performance:最近的作品(约 15 条),另有 title、like_count、comment_count、share_count、duration_seconds、is_hot(是否热门)。
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。
抖音 search 调用流程一次 抖音 search 调用的全过程:向 POST /api/v1/social 发送 platform="douyin"、action="search",以及必填参数 keyword;返回结构化 JSON,含 next_page_token、id、url、text、media_type 等字段;返回列表,单次最多 50 条,计费 $8.33 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "douyin"action: "search"keywordEveryInfra$8.33 / 千次2 · 响应 · 列表next_page_tokenidurltextmedia_type
一次 抖音 search 调用的全过程:向 POST /api/v1/social 发送 platform="douyin"、action="search",以及必填参数 keyword;返回结构化 JSON,含 next_page_token、id、url、text、media_type 等字段;返回列表,单次最多 50 条,计费 $8.33 / 千次,失败与空结果不计费。

抖音 原始字段名

EveryInfra 统一字段名

左边是 抖音 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

抖音 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 151 个字段名只在 抖音 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • author_douyin_id
  • author_uid
  • hashtag_ids
  • author_ip_location
  • forward_count
  • video_tags
  • video_resolution
  • animated_cover_url
  • city_code
  • text_language
  • video_bitrates
  • download_url
  • has_watermark
  • video_url_expires_at
  • permissions
  • author_age
  • douyin_id
  • uid

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/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。

当前目录另列出 province · industry,这些字段尚无逐项释义;请先核对 抖音 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

检索视频主题;sort 与 publish_time 分别控制排序与发布时间窗口。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

douyin_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"城市骑行"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "next_page_token": null,
  "id": null,
  "url": null,
  "text": null,
  "media_type": null,
  "video_url": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "collect_count": null,
  "view_count": null,
  "author_name": null,
  "author_id": null,
  "author_douyin_id": null,
  "author_uid": null,
  "author_bio": null,
  "author_avatar_url": null,
  "author_follower_count": null,
  "cover_image_url": null,
  "video_width": null,
  "video_height": null,
  "duration_seconds": null,
  "region": null,
  "hashtags": null,
  "posted_at": null,
  "platform": null,
  "image_urls": null,
  "duration_sec": null,
  "hashtag_ids": null,
  "search_rank": null,
  "author_is_verified": null,
  "author_following_count": null,
  "author_like_count": null,
  "author_video_count": null,
  "author_ip_location": null,
  "title": null,
  "music": null,
  "download_count": null,
  "forward_count": null,
  "is_pinned": null,
  "is_ad": null,
  "video_tags": null,
  "video_resolution": null,
  "animated_cover_url": null,
  "city": null,
  "city_code": null,
  "location": null,
  "text_language": null,
  "video_bitrates": null,
  "download_url": null,
  "has_watermark": null,
  "video_url_expires_at": null,
  "permissions": null,
  "author_gender": null,
  "author_age": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

用 secUid 核对抖音创作者资料与账号计数

用 profile 获取内容所关联的作者资料,不把抖音号、昵称与 secUid 混为一谈。

查看 profile 的 user_id 参数
  • user_id 填账号 secUid,通常以 MS4w 开头;返回的 user_id、douyin_id、nickname 分别是 secUid、抖音号和昵称。资料取自取得的视频关联作者,若没有可用作品,不能保证仅靠账号存在就能取得档案。
  • since 按 YYYY-MM-DD 筛选用于取资料的视频发布日期,不是账号注册时间,也不是历史时点画像。like_count 是账号维度的获赞数,video_count 是作品计数;不是此次取得的视频数。ip_location 不能当作精确住址或实时定位,is_verified 也不替代经营资质核验。

读取抖音单条作品,区分收藏、点赞与播放计数

用 video 看指定作品的元数据,不把作品文案当语音全文。

查看 video 的 url 参数
  • url 填完整 douyin.com/video/ 视频地址,不传用户主页或热榜链接。text 是作品文案,语音转写需另用 transcript;author_id 是作者 secUid,author_douyin_id 是作者抖音号,不能用作视频 ID。
  • collect_count 是收藏数,like_count 是点赞数,comment_count 只是评论数量。view_count 可能未公开或回传零值,不能据此断言无人观看。时长与标签的条件字段当前目录有漏项;本接口也没有视频下载、评论展开或排序筛选参数。

抖音评论 API 如何区分顶层评论、回复和作者点赞?

用 comments 读取作品讨论,并保留能确定的父子关系。

查看 comments 的 url 参数
  • url 定位一条抖音作品;结果是平铺评论行,is_reply 区分回复,reply_to_id 在可取得时关联父评论。reply_count 是声明的回复数量,不等于本次实际取得的回复行数;不能将未返回的回复补成空内容或认定已全量展开。要看某条评论下的全部回复,把它的 id 作为 comment_id、连同同一条视频的 url 交给 comment_replies。
  • 当前公开参数没有评论排序或每条评论的回复上限开关。author_id 是评论者 secUid,liked_by_author 只是作品作者点赞标记,不表示作者认可评论中的全部事实。ip_location 是平台显示的属地信息,不能推断精确位置。

抖音评论 API 怎么翻页,取完一条视频的全部顶层评论?

用 comments 传 page_token 一页页翻,楼中楼另用 comment_replies。

查看 comments 的 page_token 参数
  • 第一页传空字符串 page_token="",之后把上一页响应里的 next_page_token 原样传回,url 等其余参数不变。响应里没有 next_page_token(pagination.has_more 为 false)就是到底了。每页最多 50 条顶层评论。评论按热度翻页,评论多的视频可能少两到三成。不带 page_token 时只读头部评论,默认 20 条,最多约 50–60 条,一般没有 next_page_token。
  • 按条数分档计费:每 20 条算一次调用,一页 50 条算 3 次;一条都没返回的档不扣费。令牌 24 小时内有效,只能在同一账户、同一组参数下用;过期或参数变了会返回 422,从第一页重新开始即可。
  • 翻页只覆盖顶层评论。某条评论的 reply_count 大于 0 时,把它的 id 作为 comment_id,连同同一条视频的 url 调 comment_replies;回复也用 page_token 翻页,每页最多 20 条。

抖音评论回复 API 如何用 comment_id 取一条评论下的楼中楼?

用 comment_replies 读取某条顶层评论下的回复,看清每条回复回的是谁,翻页取完整个楼层。

查看 comment_replies 的 comment_id 参数
  • 先用 comments 取评论,挑出 reply_count 大于 0 的那条,把它的 id 作为 comment_id,与同一条视频的 url 一起传入;comment_id 不是视频 ID,也不是回复自己的 ID。每页最多 20 条,把响应里的 next_page_token 作为 page_token 传回取下一页,没有 next_page_token 即到底;不翻页时用 limit(1–100,默认 20)一次连取,每 20 条算一次调用,没返回的档不扣费。
  • 每行是一条回复:reply_to_id 固定是你请求的那条顶层评论;回复的是楼里另一条回复时,reply_to_reply_id 与 reply_to_author_name 给出被回复的那条回复和它的作者昵称,直接回复顶层评论时这两个字段没有。返回的是请求时能取到的公开回复,不承诺是楼层的全部历史;ip_location 是平台显示的属地,不能推断精确位置,liked_by_author 只是视频作者的点赞标记。

抖音搜索 API 如何用 publish_time 按发布时间筛选?

按关键词搜索视频,把近期讨论与较长时间范围的内容分开看。

查看 search 的 publish_time 参数
  • publish_time:one_day 最近 24 小时、one_week 最近 7 天、half_year 最近 6 个月、unlimited 不限。
  • 结合 text、posted_at 与 like_count 整理结果;搜索样本不是全站完整舆情,也不自带情绪判断。

抖音热榜 API 的 boards 和 hot_value 分别是什么?

用 boards 选择抖音榜单,按榜单来源整理选题。

查看 trending 的 boards 参数
  • hotspot 热点、seeding 种草、entertainment 娱乐、social 社会、challenge 挑战;可用字符串数组同时查询。
  • 保留 board、rank 与 keyword;hot_value 缺失不按零算,也不把不同榜单的热度直接混排。

按 secUid 观察博主作品

用抖音用户的 secUid 读取作品列表,整理内容主题和发布时间。

查看 user_posts 的 user_id 参数
  • user_id 不是昵称或短数字抖音号;结合 author_id、text、posted_at 与 collect_count 识别作品和互动。
  • 只分析实际返回内容;view_count 为零或缺失时,不能直接判断作品无人观看。

抖音视频口播整理

给 transcript 一个具体视频链接,读取语音文稿供后续整理。

查看 transcript 的 url 参数
  • url 使用 /video/ 视频链接;text 是文稿,title 可辅助核对目标。
  • 需要自行做摘要并回看视频核对识别结果;本接口没有声明带时间戳的 segments 字段。

怎样按关键词和粉丝区间建立抖音达人候选池?

用 creator_search 发现账号候选,再用返回的 user_id 读取资料、作品和可用的受众分析。

查看 creator_search 的 keyword 参数
  • keyword 可以是达人昵称、抖音号或相关主题词;follower_range 与 user_type 是 EveryInfra 当前公开的筛选条件。结果中的 user_id 是后续账号动作使用的 secUid,douyin_id 是抖音号,两者不能互换。
  • follower_count、gender、认证状态和来源关键词只用于缩小候选范围,不证明账号适合某次合作,也不代表粉丝是实际观众或买家。只保留实际返回的账号,不从昵称或认证信息推断经营资质。

怎样查看抖音达人的粉丝年龄、性别、地域和设备分布?

用 creator_audience 读取账号可得的受众分布与 TGI,用于判断内容受众是否接近目标人群。

查看 creator_audience 的 user_id 参数
  • user_id 填抖音账号 secUid,可从 creator_search 或 profile 结果取得。audience_distribution 是按维度组织的分布,audience_tgi 是相对指数;必须连同 dimension_code 阅读,不能把不同维度直接相加。
  • 粉丝分布不是逐个用户清单,也不等于视频观众、商品买家或真实成交人群。数据可能受授权、账号规模和可得维度限制;缺少某一维度时保持未知,不补成零。

怎样观察抖音达人的粉丝变化趋势?

用 creator_trend 保存可得的粉丝趋势和平均粉丝数,为周期性复核建立指标一致的快照。

查看 creator_trend 的 user_id 参数
  • user_id 使用账号 secUid,不是昵称或短数字抖音号。follower_trend 与 average_follower_count 应按返回的 dimension_code 和时间顺序保存;接口没有返回的日期点不能自行插值。
  • 趋势变化只能说明所取窗口内的账号指标变化,不能单独归因于某条内容、广告投放或商业合作;粉丝增长也不等于播放、成交或收入增长。

怎样把达人发布、互动和涨粉表现放进同类样本中比较?

用 creator_benchmark 读取平均值与对应分位,识别需要继续人工复核的强项和短板。

查看 creator_benchmark 的 user_id 参数
  • average_post_count、average_comment_count、average_share_count、average_like_count 与 average_follower_growth 是不同指标;对应 percentile 只在各自指标内比较,不能混成一个总分。
  • 分位值取决于当前可得的比较样本和计算方式,不是抖音官方排名、合作推荐或未来效果保证。缺失的平均值或分位保持未知,不以 0 代替。

怎样从星图达人广场建立可继续分析的商业合作候选?

用 xingtu_creator_search 按创作者关键词发现候选,比较同一次查询结果内的内容、增长、报价和商业指标。

查看 xingtu_creator_search 的 keyword 参数
  • keyword 用于星图达人发现;creator_id 是星图商业达人标识,不能与 user_id、公开主页 secUid、抖音号或昵称互换。搜索不到也可能与入驻、任务类型或账号状态有关。
  • expected_play_count 与 expected_natural_play_count 是预估,quote_1_20s_cny 等字段是按视频时长给出的报价,gmv_30d_range、gpm_30d_range 和 average_order_value_30d_range 都是区间。它们适合候选比较,不是最终合同价、保量承诺、订单明细或精确成交额。

怎样核对一位星图达人的账号画像与内容表现?

用 xingtu_creator_analytics 读取一个抖音号对应的可得星图资料,辅助人工复核候选。

查看 xingtu_creator_analytics 的 douyin_id 参数
  • douyin_id 填达人主页展示的抖音号,可从 creator_search 返回的 douyin_id 取得;它不是 secUid、nickname 或星图 creator_id。
  • average_play_count、content_themes、tags、creator_grade 和最低报价各自的统计方法不同,只能分别阅读。is_xingtu_creator 与 ecommerce_enabled 是平台标记,不证明账号资质、未来流量、成交能力或任何合作结果。缺失字段保持未知,不补成零或 false。

怎样读取星图达人的分档报价?

用 xingtu_rate_card 读取一个抖音号当前可得的报价档位,保留每档的形式和结算说明。

查看 xingtu_rate_card 的 douyin_id 参数
  • douyin_id 使用 creator_search 返回的抖音号,不传 secUid、昵称或 creator_id。rate_tiers 中的 description、video_type 与 is_open 用于区分当前可得档位;不要只取最低数字后覆盖其他档位。
  • price_cny 是当前档位报价,list_price_cny 是原报价,settlement_terms 是可得结算说明。报价可能随任务形式、视频时长、开放状态和改价生效时间变化,不是最终合同价,也不保证达人接受合作。

怎样按行业、榜单类型和时间窗筛选星图达人榜?

用 xingtu_creator_rankings 读取一个明确榜单快照,保留排名、上期名次和榜单统计范围。

查看 xingtu_creator_rankings 的 ranking_type 参数
  • industry、ranking_type 和 time_window 都是必填字段;榜单类型包括头部、高潜、带货、传播和投流等标准,时间窗包括最新周榜、最新月榜、历史周榜和月榜。目前每次最多返回 5 条榜单本身,不保证相似达人的扩展。
  • rank、previous_rank、ranking_score、cpm_cny、复购率和已完成订单区间只在同一 ranking_board、industry、period_days 与 snapshot_date 下比较。source_kind 当前只保证 ranking;榜单位置不是合作推荐,也不构成未来表现保证。

怎样按关键词建立一份抖音商城商品清单?

用 product_search 搜索商品,比较商品卡、价格、销量趋势、店铺和佣金线索。

查看 product_search 的 keyword 参数
  • keyword 是抖音商城商品关键词,结果与某位达人无绑定关系;不能把 product_search 返回的商品写成该达人历史带货商品、偏好品类或真实成交归因。category_path 应按原层级保存。
  • price_cny 是展示价格,monthly_sales 与 sales_trend 是返回的销量统计,不是独立买家人数;good_review_ratio、佣金和合作达人数也可能随时点或计划变化,cooperating_creator_count 不能证明某位指定达人带过该商品。缺失价格、销量、好评率或佣金时保持未知,不补零。

怎样读取一个抖音商城商品的图集和规格?

用 product_detail 按商品 ID 查看图片、规格、店铺和公开已售数据。

查看 product_detail 的 product_id 参数
  • product_id 填 product_search 或 live_product_search 返回的数字商品 ID;每次读取一个商品。
  • main_image_urls、detail_image_urls 和 variant_groups 按实际返回使用;图片数量和规格组数量随商品而变。

怎样按关键词发现当前直播商品?

用 live_product_search 查找当前直播商品,并保存商品与直播间标识。

查看 live_product_search 的 keyword 参数
  • keyword 填商品关键词,limit 最多为 3;直播筛选由接口固定处理,不需要额外参数。
  • live_room_id 对应本次发现的直播间;当前接口不支持按指定达人筛选完整挂车清单。

抖音话题搜索 API 如何找一个关键词相关的热门话题?

用 hashtag_search 按关键词找名字里带这个词的抖音话题,看最近 7 天的热度和作品、点赞、播放。

查看 hashtag_search 的 keyword 参数
  • keyword 填话题关键词(如 美食),limit 1–200,默认 20;每行一个话题:hashtag_id、hashtag_name、search_rank、heat_index(热度指数,只在同一次结果里比较),period_video_count、period_like_count、period_view_count 是统计时段里的量。
  • 统计时段固定为到中国时间昨天为止的最近 7 天,period_start、period_end 写明是哪几天,不能自选日期。要话题的累计播放和参与人数,把 hashtag_id 交给 hashtag_detail。

抖音话题详情 API 如何读一个话题的累计播放和参与人数?

用 hashtag_detail 按话题 ID 读这个话题从创建起的累计数据。

查看 hashtag_detail 的 hashtag_id 参数
  • hashtag_id 填纯数字话题 ID(如 1767586897793101),取自 hashtag_search 返回行;话题名或 #话题 会在扣费前被拒。
  • 返回 hashtag_name、total_view_count(累计播放)、participant_count(累计参与人数)、created_at 和话题分享链接 url;都是累计值,不是某段时间的量。

抖音热点宝视频热榜 API 如何看一段时间里最热的作品?

用 billboard_video_hot 读抖音热点宝的视频热榜:总榜、高涨粉率榜或高点赞率榜,按热度分从高到低。

查看 billboard_video_hot 的 board 参数
  • board 选 all 总榜(默认)、follower_growth 高涨粉率榜或 like_rate 高点赞率榜;time_window 选 1h、1d(默认)、3d、7d;keyword 可选,只看和这个词相关的作品(如 美食)。每行有 play_count 播放、like_count、like_rate 点赞率、new_follower_count 带来的新增关注、follower_growth_rate 涨粉率和 hot_value 热度分。
  • 一页最多 50 条、算一次调用;抖音会滤掉一部分作品,一页常常不到 50 条,不代表到底,翻页把 next_page_token 原样作为 page_token 传回,没有它才是到底(每个榜最多约 1000 条)。行上没有名次字段,按返回顺序看;图文作品 media_type 为 image,带 image_count,没有 video_url。

抖音低粉爆款榜 API 如何找粉丝不多却跑出高播放的作品?

用 billboard_low_fan_explosion 读热点宝的低粉爆款榜,找小账号的爆款选题。

查看 billboard_low_fan_explosion 的 time_window 参数
  • time_window 选 1h、1d(默认)、3d、7d,keyword 可选(如 美食)。每行带 author_follower_count 作者粉丝数,可以直接对照 play_count、like_count 看小账号的作品跑出了多少播放。
  • 翻页方式和视频热榜一样:一页最多 50 条、条数不固定,短页不代表到底,用 next_page_token 续页;行按榜单顺序给,没有名次字段。上榜只说明这段时间的数据表现,不说明作品为什么火。

抖音高完播率榜 API 如何找看完率高的作品?

用 billboard_high_completion 读热点宝的高完播率榜,找观众愿意看完的作品做参考。

查看 billboard_high_completion 的 keyword 参数
  • time_window 选 1h、1d(默认)、3d、7d,keyword 可选。每行有 duration_seconds 时长、play_count、like_count、like_rate 和 hot_value;完播率本身不在返回字段里,上榜顺序就是榜单给的顺序。
  • 一页最多 50 条、条数不固定,用 next_page_token 翻页、没有它才到底。video_url 是带签名的播放地址,会过期,要留存请及时下载。

抖音搜索热榜 API 如何看哪些词最近搜得多?

用 billboard_search_hot 读热点宝的搜索热榜,拿到上榜搜索词、名次和逐日搜索热度。

查看 billboard_search_hot 的 time_window 参数
  • time_window 选 1h、1d(默认)、3d、7d;keyword 可选,只看含这个词的搜索词。rank 是榜上名次,hot_value 是时间窗里的搜索热度,search_trend 是最多 14 天的逐日热度 [{date, value}](中国时间,从早到晚)。
  • 一页最多 50 个词、算一次调用,用 next_page_token 翻页。热度是抖音自己的指标,只在同一榜单、同一时间窗里比较,不是搜索次数。

抖音热点宝账号搜索 API 如何按关键词找同领域账号?

用 billboard_account_search 按关键词找相关抖音账号,带粉丝数、获赞数和作品数。

查看 billboard_account_search 的 keyword 参数
  • keyword 必填(如 美食)。每行一个账号:user_id 是 MS4w 开头的 secUid,可直接交给 profile、user_posts;nickname、follower_count、like_count 获赞、video_count 作品数。
  • 一页最多 30 个账号(有时少一两个,不代表到底),用 next_page_token 翻页。结果只是和关键词相关的账号,不按粉丝数排名,也不代表账号的领域认证。

抖音音乐搜索 API 如何按歌名或歌手找 BGM 和使用人数?

用 music_search 搜抖音音乐库里的音乐和原声,看每段音乐有多少作品在用。

查看 music_search 的 keyword 参数
  • keyword 填歌名、歌手或原声名(如 周杰伦)。每行一首:title、author_name、duration_seconds、use_count(用这段音乐发过的作品数,即音乐页的「N 人使用」)、cover_image_url、audio_url 播放地址、lyric_url 歌词(有才给)和 tags。
  • 一页最多 10 首、算一次调用,用 next_page_token 翻页。audio_url 可能会过期;音乐能搜到不代表可以商用,版权要另行确认。

抖音音乐详情 API 如何按音乐 ID 读一首 BGM 的使用人数?

用 music_detail 按音乐 ID 读一首抖音音乐,看标题、歌手、时长和多少作品在用。

查看 music_detail 的 music_id 参数
  • music_id 填数字音乐 ID(如 7699717253151558410,就是 music_search 结果里的 id),也可以填 douyin.com/music/<ID> 链接。
  • 返回 title、author_name、duration_seconds、use_count(用这段音乐发过的作品数)、cover_image_url、audio_url 和 lyric_url(有歌词才给)。audio_url 可能会过期;音乐下架时返回空结果。

抖音上升热点榜 API 如何找正在快速上升的热点?

用 billboard_rise_list 读热点宝上升热点榜,看哪些热点正在快速上升。

查看 billboard_rise_list 的 keyword 参数
  • 不填参数读整张榜,keyword 可按热点词过滤(如 游戏)。每页 50 条、算一次调用,用 next_page_token 翻页。
  • 每行有 rank、rank_change(比上一期上升的名次)、title、topic_id、hot_value、video_count、category、created_at 和 hot_trend(按小时的热度走势,时间是 UTC)。热度只在同一张榜里比较。

抖音挑战热榜 API 如何一次拿到整张挑战榜?

用 billboard_challenge_hot 一次读热点宝挑战热榜的全部 50 个挑战。

查看 billboard_challenge_hot 接口说明
  • 不需要参数,一次给整张榜(50 条),不翻页,limit 只能调小。
  • 每行有 rank、title、topic_id、hot_value、video_count、created_at 和 hot_trend(约每 10 分钟一个点的热度走势,时间是 UTC)。热度只在同一张榜里比较。

抖音话题热榜 API 如何按 1 小时到 7 天看话题热度?

用 billboard_topic_hot 读热点宝话题热榜,按时间窗看哪些话题在升温。

查看 billboard_topic_hot 的 time_window 参数
  • time_window 选 1h、1d(默认)、3d 或 7d,keyword 可按话题名过滤。每页 50 个话题、算一次调用,用 next_page_token 翻页,一张榜最多约 1000 个。
  • 每行有 rank、hashtag_id(可交给 hashtag_detail)、hashtag_name、hot_value、total_view_count、total_video_count、average_view_count、cover_image_url 和 daily_trend(最近最多 14 天的每日热度,按中国日期)。

抖音搜索联想词 API 如何拿到搜索框给出的补全词?

用 search_suggest 拿抖音搜索框对一个词给出的联想词,按抖音给的顺序。

查看 search_suggest 的 keyword 参数
  • keyword 填搜索框里输入的词(如 人工智能);每行一个联想词 keyword,rank 是它在搜索框里的顺序,从 1 开始。
  • 一次最多 10 个,实际常见约 5 个,不翻页。联想词反映的是搜索框此刻的补全,不带搜索量,不能当作搜索热度;要热度请用 billboard_search_hot。

星图达人转化能力 API 怎么看一个达人接星图商单后的点击和带货表现?

用 xingtu_conversion_ability 读取一个达人在近 7 / 30 / 90 天星图商单里的转化数据。

查看 xingtu_conversion_ability 的 time_window 参数
  • douyin_id 填抖音号或星图达人 ID(xingtu_creator_search 返回的 creator_id);time_window 选 7d、30d(默认)或 90d。返回相关视频数、播放中位数、组件点击量和点击率区间、CPC、GPM、平均销售额区间、带货商品数、价格区间和带货品类。
  • 区间按星图原样给(如 500-1000、10%以上),不是精确值;只有统计期内接过星图商单的达人才有数,没有时返回空结果、不扣费;达人在星图关掉销售额展示时没有销售额相关的项。

星图连接用户结构 API 怎么看达人连接了多少用户、分在哪几档?

用 xingtu_link_structure 读取星图给达人统计的连接用户四档人数和总量排名。

查看 xingtu_link_structure 的 douyin_id 参数
  • levels 按星图的档位编号 1–4 给 user_count 人数、share 占比和 industry_median_user_count 同行业中位数,四档人数相加等于 total_user_count。
  • total_rank_top_percent 是总数在星图达人里的位置,越小越靠前(0.0456 即前 4.56%);link_type 是星图给的连接类型(如 种草、传播)。这是星图自己的统计,不等于粉丝数,也不是某条视频的观众数。

星图推荐视频 API 怎么拿到达人星图主页上的代表作和商单热门视频?

用 xingtu_recommended_videos 读取达人星图主页的四组视频:代表作、最新作品、星图商单热门、个人热门。

查看 xingtu_recommended_videos 的 douyin_id 参数
  • 每条只有 id、url、play_count 播放量和 posted_at 发布时间;要点赞、评论等,把 url 交给 video。
  • 没接过星图商单的达人没有 top_xingtu_order_videos;哪一组没有视频就不给哪一组。

星图连接用户来源 API 怎么看达人的连接用户来自哪些内容类目?

用 xingtu_touch_distribution 读取星图按内容类目统计的连接用户来源。

查看 xingtu_touch_distribution 的 douyin_id 参数
  • categories 是最多三层的类目树:第一层通常分个人内容和星图内容,下面是类目和子类目,每个节点带 touch_count。
  • 类目名照星图原样给中文;同一层各节点的数可以直接比较,用来看达人的连接用户主要来自哪类内容。

星图视频表现 API 怎么比较达人的个人视频和星图视频?

用 xingtu_video_performance 读取达人个人视频和星图商单视频的互动率、播放中位数、完播率,以及最近的作品。

查看 xingtu_video_performance 的 douyin_id 参数
  • personal_videos、xingtu_videos 各有 engagement_rate、play_count_median、completion_rate,每项给 value 本值、platform_average 全平台平均和 percentile(超过多少比例的达人,0–1);比率是小数,0.0529 即 5.29%。
  • latest_videos、latest_xingtu_videos 是最近的个人作品和星图作品(各最多约 15 条),带标题、播放、点赞、评论、分享、时长;统计期内没有某类作品时不给那一组。

抖音 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

指南

抖音评论 API:评论采集从视频 URL 到保留回复关系的 JSON

抖音评论 API 与评论采集:每 20 条 $0.000556,实测每千条 $0.0283;从视频 URL 读评论和楼中楼回复,存成带回复关系的 JSON。

阅读完整文章
指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

做多平台口碑监控:从目标清单、评论身份和增量游标开始,设计可追溯的采集流程;用离线样本演示去重和采集缺口怎么发现,关键判断一律保留人工复核。

阅读完整文章
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章

抖音 API 常见问题

抖音 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="douyin"、action 和 params。以 search 为例,必填 keyword,可选 page_token、publish_time、sort。检索视频主题;sort 与 publish_time 分别控制排序与发布时间窗口。 抖音 共 37 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

抖音 API 怎么收费?

每千次 $0.56 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 62 次 抖音 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

抖音 API 一次能返回多少条数据?

抖音 有 21 个列表接口,包括 search、user_posts、comments、comment_replies、trending、creator_search、xingtu_creator_search、xingtu_creator_rankings、product_search、live_product_search、hashtag_search、billboard_video_hot、billboard_low_fan_explosion、billboard_high_completion、billboard_search_hot、billboard_account_search、music_search、search_suggest、billboard_rise_list、billboard_challenge_hot、billboard_topic_hot。其余 16 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

抖音 API 返回哪些字段?

当前目录为 search 列出 next_page_token、id、url、text、media_type、video_url 等 55 个字段名。按全站当前目录统计,151 个字段名只在 抖音 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「用 secUid 核对抖音创作者资料与账号计数」怎样接入 抖音 API?

用 profile 获取内容所关联的作者资料,不把抖音号、昵称与 secUid 混为一谈。 user_id 填账号 secUid,通常以 MS4w 开头;返回的 user_id、douyin_id、nickname 分别是 secUid、抖音号和昵称。资料取自取得的视频关联作者,若没有可用作品,不能保证仅靠账号存在就能取得档案。 since 按 YYYY-MM-DD 筛选用于取资料的视频发布日期,不是账号注册时间,也不是历史时点画像。like_count 是账号维度的获赞数,video_count 是作品计数;不是此次取得的视频数。ip_location 不能当作精确住址或实时定位,is_verified 也不替代经营资质核验。

「读取抖音单条作品,区分收藏、点赞与播放计数」怎样接入 抖音 API?

用 video 看指定作品的元数据,不把作品文案当语音全文。 url 填完整 douyin.com/video/ 视频地址,不传用户主页或热榜链接。text 是作品文案,语音转写需另用 transcript;author_id 是作者 secUid,author_douyin_id 是作者抖音号,不能用作视频 ID。 collect_count 是收藏数,like_count 是点赞数,comment_count 只是评论数量。view_count 可能未公开或回传零值,不能据此断言无人观看。时长与标签的条件字段当前目录有漏项;本接口也没有视频下载、评论展开或排序筛选参数。

抖音评论 API 如何区分顶层评论、回复和作者点赞?

用 comments 读取作品讨论,并保留能确定的父子关系。 url 定位一条抖音作品;结果是平铺评论行,is_reply 区分回复,reply_to_id 在可取得时关联父评论。reply_count 是声明的回复数量,不等于本次实际取得的回复行数;不能将未返回的回复补成空内容或认定已全量展开。要看某条评论下的全部回复,把它的 id 作为 comment_id、连同同一条视频的 url 交给 comment_replies。 当前公开参数没有评论排序或每条评论的回复上限开关。author_id 是评论者 secUid,liked_by_author 只是作品作者点赞标记,不表示作者认可评论中的全部事实。ip_location 是平台显示的属地信息,不能推断精确位置。

抖音评论 API 怎么翻页,取完一条视频的全部顶层评论?

用 comments 传 page_token 一页页翻,楼中楼另用 comment_replies。 第一页传空字符串 page_token="",之后把上一页响应里的 next_page_token 原样传回,url 等其余参数不变。响应里没有 next_page_token(pagination.has_more 为 false)就是到底了。每页最多 50 条顶层评论。评论按热度翻页,评论多的视频可能少两到三成。不带 page_token 时只读头部评论,默认 20 条,最多约 50–60 条,一般没有 next_page_token。 按条数分档计费:每 20 条算一次调用,一页 50 条算 3 次;一条都没返回的档不扣费。令牌 24 小时内有效,只能在同一账户、同一组参数下用;过期或参数变了会返回 422,从第一页重新开始即可。 翻页只覆盖顶层评论。某条评论的 reply_count 大于 0 时,把它的 id 作为 comment_id,连同同一条视频的 url 调 comment_replies;回复也用 page_token 翻页,每页最多 20 条。

可以先免费试用 抖音 API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 抖音 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 37 个能力。无需信用卡。

开始调用 抖音 API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 抖音 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策