抖音用某段音乐的作品 API
按 music_id 读用了同一段抖音音乐的作品,每行带 text、like_count、comment_count、author_name 和 music_post_count,每千次 $0.79。
music_post_count是抖音记的使用作品数,返回的行通常少得多- 一次调用返回整份列表,没有翻页
- 失败和空结果不收费
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
1请求
POST /api/v1/social { "platform": "douyin", "action": "music_posts", "params": { "music_id": "7699717253151558410" } }2JSON 响应
{ "results": [ { "text": string, "media_type": string, "video_url": string, "like_count": number }, … ] }3行
text media_type video_url like_count string string string number 4CSV
douyin-music_posts-sample.csv id,url,text,media_type,video_url,like_count,comment_count,share_count,collect_count,author_name,author_id,author_douyin_id,author_bio,author_avatar_url,author_follower_count,author_following_count,author_like_count,author_video_count,author_is_verified,cover_image_url,video_width,video_height,video_bitrates,has_watermark,duration_sec,duration_seconds,hashtags,posted_at,title,music,location,image_urls,is_deleted,is_private,platform,music_post_count
music_id,返回一份作品列表,results 里每行是一条作品,列成字段表,也可下载为 CSV。能拿到什么数据
这个能力还没有公开的真实样本。下表列出每行会返回的字段、类型和含义,不放值。
| 字段 | 类型 | 含义 |
|---|---|---|
| id | string | 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。 |
| url | string | 该记录在原平台上的可访问链接。 |
| text | string | 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。 |
| media_type | string | 媒体类型。 |
| video_url | string | 视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。 |
| like_count | number | 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。 |
| comment_count | number | 评论数。null 表示不公开,不等于 0。 |
| share_count | number | 分享/转发数。null 表示不公开,不等于 0。 |
| collect_count | number | 收藏数。null 表示不公开,不等于 0。 |
| author_name | string | 作者昵称(显示名)。 |
| author_id | string | 作者在原平台的唯一 ID。 |
| author_douyin_id | string | 作者抖音号。 |
| author_bio | string | 作者主页简介(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上)。 |
| author_avatar_url | string | 作者头像链接:search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上是博主的,live_room 上是主播的,comments 行上是评论者的。 |
| author_follower_count | number | 作者粉丝数。null 表示不公开。 |
| author_following_count | number | 作者关注数(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上)。 |
| author_like_count | number | 作者主页获赞总数(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript)。 |
| author_video_count | number | 作者作品总数(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上)。 |
| author_is_verified | boolean | 作者是否认证(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上;live_room 上是主播是否认证;comments 行上是评论者是否认证)。 |
| cover_image_url | string | 封面图链接:search / user_posts / posts_batch / related_posts / mix_posts / music_posts / media_links 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图,user_mixes 是合集封面,live_room 是直播间封面;带签名的会过期。 |
| video_width | number | 视频画面宽度(像素)。 |
| video_height | number | 视频画面高度(像素)。 |
| video_bitrates | array | 各清晰度播放地址:[{quality(清晰度名), bitrate(码率,bps), fps, is_h265(是否 H.265 编码), width, height(像素), url}],来源没给的项不出现;地址带签名、会过期(见 video_url_expires_at)。 |
| has_watermark | boolean | 平台对这条作品视频文件的水印标记(true 表示带水印)。 |
| duration_sec | number | 视频时长(秒)。 |
| duration_seconds | number | 时长,单位秒。非视频/音频内容为 null。 |
| hashtags | array | 正文里的话题标签数组,按出现顺序;没有时不出现这个字段。 |
| posted_at | string | 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。 |
| title | string | 标题。平台无标题概念时(如纯文本帖)为 null。 |
| music | object | 作品背景音乐:id、title(曲名)、author(演唱/作者)、is_original(是否原声)、duration_sec(秒)、cover_url、play_url(音频地址,可能会过期);没有音乐信息时没有这个键。 |
| 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;作品没带定位时没有这个键。 |
| image_urls | — | 图片链接数组,按平台展示顺序;没有图片时不出现这个字段。 |
| is_deleted | boolean | 作品已被删除时为 true;抖音在作品行上标了才有这个键。 |
| is_private | boolean | 作品仅自己可见(私密)时为 true;抖音在作品行上标了才有这个键。 |
| platform | string | 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。 |
| music_post_count | — | 抖音记的用了这段音乐的作品数(music_posts),每行相同;music_posts 只给抖音展示的一小部分,通常少得多。 |
用途
看一段音乐都配了什么内容
读各行的
text和hashtags,看用这段音乐的作品在讲什么。找用这段音乐的账号
读
author_id和author_follower_count,列出用它发过作品的账号和规模。比较作品互动
比较各行的
like_count、comment_count、share_count,找出用这段音乐表现最好的几条。和音乐详情搭配
先用
music_detail读use_count,再用这一页看抖音展示出来的那部分作品。
抖音开放平台 与 EveryInfra 对比
下面拿抖音开放平台「总体授权说明」里的原文,对比 EveryInfra music_posts 怎么接入。
| 对比项 | 抖音开放平台 | EveryInfra |
|---|---|---|
| 权限申请 | "根据接口权限不同,开放平台提供三种不同权限下的用户权限的状态样式,您可以根据获取权限点的实际场景,按需申请。" | 不用按权限点申请;同一把 EveryInfra API Key 还能调用抖音的其他能力,请求只带 music_id。 |
引文出自抖音开放平台「总体授权说明」页,2026-11-22 核对;页面没有标更新日期。抖音官方文档没有讲同一段音乐下的作品,所以这里只比接入方式。 官方出处: 总体授权说明
限制和注意事项
music_id必填,是纯数字 ID,取自作品行里music的id或music_detail;也收 douyin.com/music/<ID> 链接。music_post_count是抖音记的使用作品数,每行相同;抖音只展示其中一部分,返回的行通常远少于它。- 一次调用返回整份列表,没有翻页。
video_url带签名、会过期,要留存请及时下载。- 有些作品行带
is_deleted或is_private,抖音标了才有这个键。
价格
每次调用 $0.000792,按次计费,不按作品条数算;一次调用返回一份列表。失败和空结果不收费。
| 调用次数 | 费用 |
|---|---|
| 10,000 | $7.92 |
| 100,000 | $79.17 |
| 1,000,000 | $791.67 |
合计按每次调用的标价算。
代码示例
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "douyin",
"action": "music_posts",
"params": {
"music_id": "7699717253151558410"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
API 参考
下面是 music_posts 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。
AI 提示词
#请帮我用 EveryInfra 的「抖音用某段音乐的作品」接口(douyin/music_posts)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 douyin,action 填 music_posts,参数放在 params 里。
- 必填参数:
- music_id:抖音音乐 ID,纯数字,取自作品 music.id 或 music_detail;也收 douyin.com/music/<ID> 链接。
- 可选参数:
- limit:这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。
- 返回一组记录,每条记录的主要字段:id、url、text、media_type(媒体类型)、video_url(视频播放地址(带签名、会过期)、like_count、comment_count、share_count、collect_count、author_name、author_id、author_douyin_id(作者抖音号);一共 35 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin。
- 示例请求体:
{
"platform": "douyin",
"action": "music_posts",
"params": {
"music_id": "7699717253151558410"
}
}
- 计费:$0.79 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | douyin | 平台标识,固定值。 |
action | body | string | 是 | music_posts | 能力标识,固定值。 |
music_id | body.params | string | 是 | - | 抖音音乐 ID,纯数字,取自作品 music.id 或 music_detail;也收 douyin.com/music/<ID> 链接。 |
limit | body.params | integer (1–) | 否 | - | 这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。 |
响应示例
#{ "id": "req_…", "platform": "douyin", "action": "music_posts", "results": [ { "id": …, "url": …, "text": …, "media_type": …, "video_url": …, "like_count": …, "comment_count": …, "share_count": …, "collect_count": …, "author_name": …, "author_id": …, "author_douyin_id": …, "author_bio": …, "author_avatar_url": …, "author_follower_count": …, "author_following_count": …, "author_like_count": …, "author_video_count": …, "author_is_verified": …, "cover_image_url": …, "video_width": …, "video_height": …, "video_bitrates": …, "has_watermark": …, "duration_sec": …, "duration_seconds": …, "hashtags": …, "posted_at": …, "title": …, "music": …, "location": …, "image_urls": …, "is_deleted": …, "is_private": …, "platform": …, "music_post_count": … } ], "count": …, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
id | 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。 |
url | 该记录在原平台上的可访问链接。 |
text | 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。 |
media_type | 媒体类型。 |
video_url | 视频播放地址(带签名、会过期,要留存请及时下载);图文笔记或来源没给时为 null。 |
like_count | 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。 |
comment_count | 评论数。null 表示不公开,不等于 0。 |
share_count | 分享/转发数。null 表示不公开,不等于 0。 |
collect_count | 收藏数。null 表示不公开,不等于 0。 |
author_name | 作者昵称(显示名)。 |
author_id | 作者在原平台的唯一 ID。 |
author_douyin_id | 作者抖音号。 |
author_bio | 作者主页简介(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上)。 |
author_avatar_url | 作者头像链接:search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上是博主的,live_room 上是主播的,comments 行上是评论者的。 |
author_follower_count | 作者粉丝数。null 表示不公开。 |
author_following_count | 作者关注数(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上)。 |
author_like_count | 作者主页获赞总数(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript)。 |
author_video_count | 作者作品总数(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上)。 |
author_is_verified | 作者是否认证(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上;live_room 上是主播是否认证;comments 行上是评论者是否认证)。 |
cover_image_url | 封面图链接:search / user_posts / posts_batch / related_posts / mix_posts / music_posts / media_links 是作品封面,music_search / music_detail 是音乐封面,billboard_topic_hot 是话题配图,user_mixes 是合集封面,live_room 是直播间封面;带签名的会过期。 |
video_width | 视频画面宽度(像素)。 |
video_height | 视频画面高度(像素)。 |
video_bitrates | 各清晰度播放地址:[{quality(清晰度名), bitrate(码率,bps), fps, is_h265(是否 H.265 编码), width, height(像素), url}],来源没给的项不出现;地址带签名、会过期(见 video_url_expires_at)。 |
has_watermark | 平台对这条作品视频文件的水印标记(true 表示带水印)。 |
duration_sec | 视频时长(秒)。 |
duration_seconds | 时长,单位秒。非视频/音频内容为 null。 |
hashtags | 正文里的话题标签数组,按出现顺序;没有时不出现这个字段。 |
posted_at | 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。 |
title | 标题。平台无标题概念时(如纯文本帖)为 null。 |
music | 作品背景音乐:id、title(曲名)、author(演唱/作者)、is_original(是否原声)、duration_sec(秒)、cover_url、play_url(音频地址,可能会过期);没有音乐信息时没有这个键。 |
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;作品没带定位时没有这个键。 |
image_urls | 图片链接数组,按平台展示顺序;没有图片时不出现这个字段。 |
is_deleted | 作品已被删除时为 true;抖音在作品行上标了才有这个键。 |
is_private | 作品仅自己可见(私密)时为 true;抖音在作品行上标了才有这个键。 |
platform | 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。 |
music_post_count | 抖音记的用了这段音乐的作品数(music_posts),每行相同;music_posts 只给抖音展示的一小部分,通常少得多。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
常见问题
抖音音乐作品接口返回什么?
一份作品列表,每行一条作品:id、url、text、media_type、like_count、comment_count、share_count、collect_count、作者字段、hashtags、posted_at 等,另有 music_post_count。
为什么返回的行比 music_post_count 少很多?
music_post_count 是抖音记的使用作品数,而抖音只展示其中一部分,接口读到的就是展示出来的这部分。
music_id 从哪里来?
取自作品行里 music 的 id,或者 music_detail;douyin.com/music/<ID> 形式的链接也行。
读一份要多少钱?
每次 $0.000792,每千次 $0.79,按调用次数算,不按作品条数算。失败和空结果不收费。
相关的 抖音 能力
同一把 Key 还能调用抖音的其他能力。
- 关键词搜索
search每千次 $8.33关键词搜索:返回列表,默认 10 条、单次最多 50 条;主要字段 next_page_token、id、url、text、media_type、video_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 主页或对象详情
profile每千次 $0.56主页或对象详情:返回单个对象;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。 - 用户内容
user_posts每千次 $0.56用户内容:返回列表,默认 20 条、单次最多 100 条;主要字段 next_page_token、id、url、text、media_type、video_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 视频详情
video每千次 $0.56视频详情:返回单个对象;主要字段 id、url、text、media_type、video_url、like_count。 - 评论
comments每千次 $0.56评论:返回列表,默认 20 条、单次最多 150 条;主要字段 next_page_token、id、text、like_count、reply_count、author_name。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 20 条算一次调用。 - 评论回复
comment_replies每千次 $0.56评论回复:返回列表,默认 20 条、单次最多 100 条;主要字段 next_page_token、id、text、like_count、author_name、author_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 20 条算一次调用。 - 热榜
trending每千次 $0.56热榜:返回列表,默认 20 条、单次最多 60 条;主要字段 rank、keyword、hot_value、video_count、board、image_url。 - 视频文稿
transcript每千次 $0.56视频文稿:返回单个对象;主要字段 id、url、title、text、posted_at、play_count。 - 达人搜索
creator_search每千次 $0.56达人搜索:返回列表,默认 20 条、单次最多 20 条;主要字段 user_id、douyin_id、nickname、url、avatar_url、follower_count。 - 达人粉丝画像
creator_audience每千次 $0.56达人粉丝画像:返回单个对象;主要字段 user_id、audience_distribution、audience_tgi、dimension_code、platform。 - 达人涨粉趋势
creator_trend每千次 $0.56达人涨粉趋势:返回单个对象;主要字段 user_id、follower_trend、average_follower_count、dimension_code、platform。 - 同类达人对比
creator_benchmark每千次 $0.56同类达人对比:返回单个对象;主要字段 user_id、average_post_count、average_comment_count、average_share_count、average_follower_growth、average_like_count。 - 星图达人搜索
xingtu_creator_search每千次 $0.56星图达人搜索:返回列表,默认 20 条、单次最多 20 条;主要字段 creator_id、user_id、nickname、follower_count、gender、city。 - 星图达人分析
xingtu_creator_analytics每千次 $0.56星图达人分析:返回单个对象;主要字段 creator_id、creator_type、follower_count、average_play_count、city、province。 - 星图达人报价
xingtu_rate_card每千次 $0.56星图达人报价:返回单个对象;主要字段 creator_id、rate_tiers、platform。 - 星图达人榜单
xingtu_creator_rankings每千次 $0.56星图达人榜单:返回列表,默认 5 条、单次最多 5 条;主要字段 creator_id、user_id、url、nickname、avatar_url、gender。 - 商品搜索
product_search每千次 $8商品搜索:返回列表。按关键词搜索抖音商城商品,一页最多 30 条,返回价格、近 30 天销量、好评率、店铺、类目、佣金和合作达人数。目前只出第 1 页,第 2 页起(不管用 page_token 还是 page)暂时回 503、不扣费;每页算一次调用。主来源暂时不可用时改由备用来源返回,这时最多 5 条、没有下一页,且只有 product_id、title、url、image_url、price_cny、price_cny_minor、shop_id、source_keyword 和 search_rank,promotion_id、white_image_url、price_label、monthly_sales、good_review_ratio、sales_trend、category_path、category_ids、category_depth、shop_name、shop_logo_url、shop_score、commission_rate_percent、commission_cny、cooperating_creator_count、tags、recommend_reason 都不出现;标价在一角及以下的是引流起售价,不返回价格。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 店铺商品
shop_products每千次 $8店铺商品:返回列表,每次一页、固定 10 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 next_page_token、product_id、promotion_id、title、url、image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 商品详情
product_detail每千次 $8商品详情:返回单个对象;主要字段 product_id、title、price_cny、discount_price_cny、sales_text、sold_count。 - 直播商品搜索
live_product_search每千次 $0.56直播商品搜索:返回列表,默认 3 条、单次最多 3 条;主要字段 product_id、sku_id、title、image_url、price_cny、shop_id。 - 话题搜索
hashtag_search每千次 $15.56话题搜索:返回列表,默认 20 条、单次最多 200 条;主要字段 hashtag_id、hashtag_name、search_rank、heat_index、period_video_count、period_like_count。 - 话题详情
hashtag_detail每千次 $15.56话题详情:返回单个对象;主要字段 hashtag_id、hashtag_name、total_view_count、participant_count、created_at、url。 - 热点宝视频热榜
billboard_video_hot每千次 $0.81热点宝视频热榜:返回列表,每次一页、每页最多 50 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、image_count、cover_image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝低粉爆款榜
billboard_low_fan_explosion每千次 $0.81热点宝低粉爆款榜:返回列表,每次一页、每页最多 50 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、image_count、cover_image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝高完播率榜
billboard_high_completion每千次 $0.81热点宝高完播率榜:返回列表,每次一页、每页最多 50 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、image_count、cover_image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝搜索热榜
billboard_search_hot每千次 $0.81热点宝搜索热榜:返回列表,每次一页、固定 50 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、keyword、hot_value、search_trend、platform。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝账号搜索
billboard_account_search每千次 $0.81热点宝账号搜索:返回列表,每次一页、每页最多 30 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 user_id、nickname、url、avatar_url、follower_count、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 音乐搜索
music_search每千次 $8音乐搜索:返回列表,每次一页、固定 10 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 id、url、title、author_name、duration_seconds、duration_sec。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 搜索联想词
search_suggest每千次 $8搜索联想词:返回列表,默认 10 条、单次最多 10 条;主要字段 rank、keyword、platform。 - 热点宝上升热点榜
billboard_rise_list每千次 $0.81热点宝上升热点榜:返回列表,每次一页、固定 50 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、rank_change、title、topic_id、hot_value、video_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝挑战热榜
billboard_challenge_hot每千次 $0.81热点宝挑战热榜:返回列表,默认 50 条、单次最多 50 条(传更大的数按 50 条返回);主要字段 rank、title、topic_id、hot_value、video_count、created_at。 - 热点宝话题热榜
billboard_topic_hot每千次 $0.81热点宝话题热榜:返回列表,每次一页、固定 50 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、hashtag_id、hashtag_name、hot_value、total_view_count、total_video_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 音乐详情
music_detail每千次 $0.81音乐详情:返回单个对象;主要字段 id、url、title、author_name、duration_seconds、duration_sec。 - 星图达人转化能力
xingtu_conversion_ability每千次 $1.6星图达人转化能力:返回单个对象;主要字段 creator_id、time_window、related_video_count、video_play_median、component_click_count_range、component_click_rate_range。 - 星图达人连接用户结构
xingtu_link_structure每千次 $16星图达人连接用户结构:返回单个对象;主要字段 creator_id、link_type、total_user_count、total_rank_top_percent、levels、platform。 - 星图达人推荐视频
xingtu_recommended_videos每千次 $1.6星图达人推荐视频:返回单个对象;主要字段 creator_id、signature_videos、latest_videos、top_xingtu_order_videos、top_personal_videos、platform。 - 星图达人连接用户来源
xingtu_touch_distribution每千次 $16星图达人连接用户来源:返回单个对象;主要字段 creator_id、categories、platform。 - 星图达人视频表现
xingtu_video_performance每千次 $16星图达人视频表现:返回单个对象;主要字段 creator_id、personal_videos、xingtu_videos、latest_videos、latest_xingtu_videos、platform。 - 批量查作品
posts_batch每千次 $0.56批量查作品:返回列表;主要字段 id、url、text、media_type、video_url、like_count。 - 批量查作者
profiles_batch每千次 $0.56批量查作者:返回列表;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。 - 作品下载链接
media_links每千次 $0.56作品下载链接:返回列表;主要字段 id、url、media_type、video_url、video_url_expires_at、video_width。 - 相关推荐作品
related_posts每千次 $0.56相关推荐作品:返回列表;主要字段 id、url、text、media_type、video_url、like_count。 - 作品数据历史
post_history每千次 $0.79作品数据历史:返回列表;主要字段 video_id、captured_at、like_count、comment_count、share_count、collect_count。 - 链接识别
resolve_links每千次 $0.79链接识别:返回列表;主要字段 matched_text、match_type、resource_type、resource_id、handle、url。 - 热榜历史
trending_history每千次 $0.79热榜历史:返回列表;主要字段 keyword、board、first_seen_at、last_seen_at、snapshot_count、best_rank。 - 作者的合集
user_mixes每千次 $0.79作者的合集:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 mix_id、name、description、url、cover_image_url、author_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 合集里的作品
mix_posts每千次 $0.79合集里的作品:返回列表,每次一页、每页最多 15 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、video_url、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 作者一览
user_overview每千次 $1.6作者一览:返回单个对象;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。 - 直播间
live_room每千次 $0.79直播间:返回单个对象;主要字段 room_id、live_id、title、is_live、url、cover_image_url。 - 推荐流
feed每千次 $0.56推荐流:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、video_url、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 短剧频道
series_feed每千次 $0.56短剧频道:返回列表,每次一页、每页最多 16 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 series_id、name、description、url、cover_image_url、genres。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 短剧分集
series_posts每千次 $0.79短剧分集:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、video_url、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 作者的短剧
user_series每千次 $0.79作者的短剧:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 series_id、name、description、url、cover_image_url、genres。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 弹幕
danmaku每千次 $0.56弹幕:返回列表;主要字段 id、text、video_id、video_time、video_time_seconds、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 直播间观众榜
live_viewers每千次 $0.56直播间观众榜:返回列表;主要字段 rank、user_id、douyin_id、nickname、avatar_url、is_verified。 - 短剧详情
series_detail每千次 $0.79短剧详情:返回单个对象;主要字段 series_id、name、description、url、cover_image_url、genres。 - 合集详情
mix_detail每千次 $0.56合集详情:返回单个对象;主要字段 mix_id、name、description、url、cover_image_url、episode_count。 - 直播场次详情
live_session每千次 $0.79直播场次详情:返回单个对象;主要字段 room_id、live_id、title、is_live、url、cover_image_url。 - 主播直播状态
user_live每千次 $0.79主播直播状态:返回单个对象;主要字段 room_id、live_id、title、is_live、url、cover_image_url。 - 按数字 UID 查主页
profile_by_id每千次 $0.56按数字 UID 查主页:返回单个对象;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。