TikTok 音乐榜 API

Q: top50 和 viral50 该选哪张榜？

要看整体最热的歌选 top50，这是默认值；要看近期走红的歌选 viral50。两张榜都是一次给整榜 50 首，名次以 rank 为准，limit 传得再大也只按 50 条返回。

Q: 榜单里的歌怎么继续查用了它的视频？

榜单每行的 id 就是音乐 ID，把它填进「用某音乐的视频」那一页的音乐 ID 参数，就能读到用了这首歌的视频。比较几首歌的热度，可以先看每行的 use_count。

Q: audio_url 是整首歌的下载地址吗？

不是。它是试听链接，多为 60 秒片段，带签名、会过期。原声或没登记的歌不出现 album 和 released_at，读取前先判断字段在不在；is_commercial 标出这首歌是否属于 TikTok 商用曲库。

POST

接口健康状态

24h 健康值: 正常
24h 平均耗时: —

健康 / 正常
可用
少量可用
基本不可用

正常

24 小时趋势

30 天趋势

音乐榜：返回列表，默认 50 条、单次最多 50 条（传更大的数按 50 条返回）；主要字段 rank、id、url、title、author_name、album。

TikTok 音乐榜一次给出整张榜单，默认 50 首，每首带 rank 名次、曲名、歌手、专辑、时长、用过这首音乐的视频数 use_count，以及试听链接 audio_url。它回答「现在 TikTok 上哪些歌最热、哪些在走红」，适合给短视频选配乐、观察榜单更替，或者把热歌接到视频侧，看它们是怎么被使用的。

chart 默认 top50，viral50 是近期在 TikTok 上走红的歌。按官方创作者学院的说明，Top 50 按创作量、播放量和互动计算，是美国的热门歌曲周榜，Viral 50 按全球互动选出上升最快的歌。榜单没有关键词和翻页参数，要按歌名、歌手查某一首，用音乐搜索那一页，它每页最多 20 首、需要翻页。

单价 $0.81 / 千次（每次 $0.000806），失败与空结果不扣费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

AI 提示词

请帮我用 EveryInfra 的「TikTok 音乐榜」接口（tiktok/music_chart）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 tiktok，action 填 music_chart，参数放在 params 里。
- 没有必填参数。
- 可选参数：
  - chart：榜单：top50（TikTok 音乐 Top 50，默认）或 viral50（Viral 50，近期在 TikTok 上走红的歌）。一次给整榜 50 首。（可选值：top50 / viral50）
  - limit：这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。（默认 50）
- 返回一组记录，每条记录的主要字段：rank（名次）、id、url、title、author_name（评价人名字（shop_produc…）、album（专辑名（music_search…）、language、duration_seconds、duration_sec、use_count（用过这首音乐的视频数（music_…）、is_commercial（是否 TikTok 商用曲库里的音…）、released_at（音乐发行日期（music_sear…）；一共 14 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok。
- 示例请求体：
{
  "platform": "tiktok",
  "action": "music_chart",
  "params": {}
}
- 计费：$0.81 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "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`	是	`tiktok`	平台标识，固定值。
`action`	body	`string`	是	`music_chart`	能力标识，固定值。
`chart`	body.params	`string (enum)`	否	-	榜单：top50（TikTok 音乐 Top 50，默认）或 viral50（Viral 50，近期在 TikTok 上走红的歌）。一次给整榜 50 首。允许值`top50viral50`
`limit`	body.params	`integer (1–50)`	否	`50`	这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "tiktok",
  "action": "music_chart",
  "params": {}
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

响应示例

字段预览

这组示例参数还没有真实样例：这里只按接口定义列出响应结构和字段，值用 … 占位，不是一次真实调用的结果。

json

{
  "id": "req_…",
  "platform": "tiktok",
  "action": "music_chart",
  "results": [
    {
      "rank": …,
      "id": …,
      "url": …,
      "title": …,
      "author_name": …,
      "album": …,
      "language": …,
      "duration_seconds": …,
      "duration_sec": …,
      "use_count": …,
      "is_commercial": …,
      "released_at": …,
      "cover_image_url": …,
      "audio_url": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被补造。

字段	含义
`rank`	名次，从 1 起（music_chart / shop_hot_products）。
`id`	该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
`url`	该记录在原平台上的可访问链接。
`title`	标题。平台无标题概念时（如纯文本帖）为 null。
`author_name`	评价人名字（shop_product_reviews），平台已打码，如 n**h。
`album`	专辑名（music_search / music_chart）；原声、没登记专辑的没有这个字段。
`language`	内容语言代码（如 zh、en），由平台判定，可能不准。
`duration_seconds`	时长，单位秒。非视频/音频内容为 null。
`duration_sec`	保留平台原语义
`use_count`	用过这首音乐的视频数（music_search / music_chart）。
`is_commercial`	是否 TikTok 商用曲库里的音乐（music_search / music_chart）。
`released_at`	音乐发行日期（music_search / music_chart）；原声、没登记发行日期的没有这个字段。
`cover_image_url`	视频封面图链接（带签名，会过期）。
`audio_url`	试听音频链接（music_search / music_chart），多为 60 秒片段，带签名、会过期。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

常见问题

`top50` 和 `viral50` 该选哪张榜？

要看整体最热的歌选 top50，这是默认值；要看近期走红的歌选 viral50。两张榜都是一次给整榜 50 首，名次以 rank 为准，limit 传得再大也只按 50 条返回。

榜单里的歌怎么继续查用了它的视频？

榜单每行的 id 就是音乐 ID，把它填进「用某音乐的视频」那一页的音乐 ID 参数，就能读到用了这首歌的视频。比较几首歌的热度，可以先看每行的 use_count。

`audio_url` 是整首歌的下载地址吗？

不是。它是试听链接，多为 60 秒片段，带签名、会过期。原声或没登记的歌不出现 album 和 released_at，读取前先判断字段在不在；is_commercial 标出这首歌是否属于 TikTok 商用曲库。

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码

官方资料参照

只用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。

TikTok 创作者学院：TikTok Billboard Top 50 与 Viral 50 榜 ↗
TikTok 官方创作者学院说明 TikTok Billboard Top 50 是按创作量、播放量和互动算的美国 TikTok 热门歌曲周榜，Viral 50 是 App 内独有、按全球互动选出上升最快歌曲的榜单，两张榜都能从 App 的音乐详情页打开。可证明 top50、viral50 两张榜的对象和口径；不证明本接口返回的字段、刷新时间与 App 内同步。
核对于 2026-11-01