TikTok Song API

TikTok Song

主要特性

• 双重输入解析支持直接输入数字 clip ID，或者提供完整的公开 TikTok 原声音乐页面链接。
• 曲目与艺术家元数据提取官方歌曲标题、歌手 handle、显示昵称、所属专辑名称和高清封面图片链接。
• 试听流与时长获得公开音频播放直链和高精度时长数值，方便下游媒体服务直接消费。
• 视频使用总量统计提供 user_count 指标，清晰呈现全网使用该音频拍摄并发布的公开视频总数。

参数

如何使用

提交原声 clip ID 或音乐页面 URL 作为异步任务，轮询获取标准化音频详情。

1. 从任意 TikTok 视频的原声链接或分享链接中取得数字 clip ID 或 URL。
2. 向 /v1/tiktok/song 发送 POST 请求，传入 music_id 或 url 参数。
3. 轮询 /v1/tasks/{task_id} 直至状态变为 succeeded。
4. 在 data.results.items 中读取返回的标准化音乐对象。

curl -X POST "https://api.socq.ai/v1/tiktok/song" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"music_id":"7439295283975702544"}'

# 或传 {"url":"https://www.tiktok.com/music/Different-Acoustic-6717159721276540930"}

最佳使用场景

• 热门 BGM 趋势生命周期监测： 定期跟踪同款视频使用数变化，研判特定音乐是处于爆发期、平稳期还是衰退期。
• 音乐版权与曲库元数据补全： 为发行商或创作者曲库批量匹配 TikTok 平台关联 ID、原声封面与时长规格。
• 爆款音频归因研究： 挖掘短视频出圈热门片段背后的原始歌曲、作者身份与原声出处。

使用建议

• TikTok 音乐页面的链接尾部通常包含一串纯数字 ID，直接传入该 ID 或完整链接均可被正确识别。
• 解析得到 music_id 后，可紧接着调用 TikTok Song Videos 接口批量获取使用了该原声的全部视频。
• 响应对象中的 metrics.videos_count 字段即为使用该声音的视频总数。
• 对于普通用户录制的原创原声，在 extra 元数据中 is_original 会标识为 true。

相关 API