tiktok/
search-music

按关键词搜索 TikTok 音乐,直接看到每首音乐被多少视频使用,并返回音乐 ID、标题、歌手、封面、时长和试听地址,可按相关度、使用量或最新排序。

TikTok Sound Search API

关键词搜索
音乐使用视频数
按使用量排序
每条结果 0.6 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Sound Search

TikTok 上的 Sound 就是视频配的音频,可能是音乐库里的歌曲,也可能是创作者自己录的一段声音;每条音频都有独立页面,上面有标题、歌手或上传者、封面,以及一个不断累加的使用视频数。这个数字最直接地说明一首音乐是小众、已经成熟还是正在起量,而音乐 ID 则是把一首歌和用到它的视频对应起来的凭据。

TikTok Sound Search API 主要特性

  • 按歌名、歌手或情绪搜索query 可以填歌名、歌手名,或者 lofi 这类情绪、曲风词,返回 TikTok 与之匹配的音乐。
  • 每首音乐的使用视频数metrics.videos_count 是使用该音乐的视频总数,一眼就能把成熟的热门音乐和小众音乐区分开。
  • 三种排序方式sort_by 支持 relevance、most_used 和 latest,同一个关键词既能找已经验证过的音乐,也能找刚上线的新音乐。
  • 指定搜索市场region 填两位国家代码即可搜索对应的 TikTok 市场,不填默认 US。
  • 带试听的音乐记录每条结果包含音乐页链接 url、audio.id、标题、歌手、cover_url、duration_seconds,以及可播放的 audio.url。

TikTok Sound Search API 参数

参数必填描述
query必填要搜索的歌名、歌手或音乐名称。
sort_by可选结果排序:relevance(默认)、most_used 或 latest。
region可选要搜索的 TikTok 市场的两位国家代码,默认 US。
results_limit可选返回的音乐数量,取值 1 到 500,默认 20。

如何使用 TikTok Sound Search API

用关键词搜索,分页读取匹配的音乐。

  1. 向 /v1/tiktok/search-music 发送 {"query": "lofi", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取音乐;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"lofi","sort_by":"most_used","results_limit":20}'

# metrics.videos_count 是使用每首音乐的视频数。

TikTok Sound Search API 最佳使用场景

  • 为品牌视频挑 BGM: 按情绪词搜索并用 most_used 排序,再结合 videos_count、duration_seconds 和试听音频,挑出既经过验证又贴合视频时长的音乐。
  • 提早发现新音乐: 同一个关键词改用 latest 排序,留下 videos_count 还很小的音乐,赶在它们进入热门盘点之前介入。
  • 把歌曲对应到音乐 ID: 用歌名加歌手搜索,核对 audio.artist 后保存 audio.id,之后就能追踪使用这首确切音乐的视频。
  • 分市场整理音乐清单: 同一个关键词换不同的 region 重复搜索,为活动覆盖的每个国家各做一份候选清单。

TikTok Sound Search API 使用建议

  • 找正版歌曲时,歌名最好和歌手一起搜;像 Lofi 这样的短标题会匹配大量无关音乐,保存 audio.id 之前先核对 audio.artist。
  • 合并多个关键词的搜索结果时按 id 去重,因为同一首音乐可能被多个关键词命中。
  • videos_count 是累计总数,不是增长率;想知道哪些音乐在加速,就定时运行同一个搜索,比较前后两次的数字。
  • 如果需要保存音频或封面文件,任务完成后尽快下载 audio.url 和 cover_url,TikTok 提供的是带签名的链接,过一段时间会失效。

除了 TikTok Sound Search API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。

  • TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
  • TikTok Search API — 按关键词搜索公开视频,并支持排序和发布时间筛选。
  • TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间,返回状态、主播信息、封面和受众计数。
  • TikTok Song API — 通过片段 ID 或音乐 URL 获取公开原声元数据。
  • TikTok Song Videos API — 按指定原声 ID 采集使用该原声的公开视频。
  • TikTok Popular Songs API — 获取 TikTok App 的 Top 50 或 Viral 50 歌曲榜,查看曲名、艺术家、原声 ID 及使用该原声的视频数。

探索其他平台

还可以将 TikTok 数据与其他已支持社交平台的公开数据结合使用。

TikTok Sound Search API — 常见问题

TikTok Sound Search API 是一个用于按歌名、歌手或情绪等关键词搜索 TikTok 音乐的 API。它返回每首音乐的 ID、标题、歌手、封面、时长、试听音频和使用它的视频数。

搜索歌名,歌名常见时再加上歌手,在匹配的结果里读取 metrics.videos_count,就是使用这首音乐的视频总数。

不是。TikTok App 里的那个功能是通过唱、哼或播放来识别歌曲;这个接口按文字搜索,返回与歌名、歌手或情绪匹配的音乐,不能根据录音识别音频。

把 sort_by 设为 most_used 时使用最多的音乐排在前面,设为 latest 时最新的排在前面,默认的 relevance 则按与关键词的匹配程度排序。

取结果里的音乐 id,发送给 TikTok Song Videos,它会采集用了这首音乐的视频。

默认是美国市场;region 填两位国家代码,就会改在对应国家的 TikTok 市场搜索。

results_limit 取值 1 到 500,默认 20。每返回一首音乐扣 0.6 积分,没有任何匹配的搜索不扣费。