TikTok Song Videos
追踪使用同一背景音乐的视频可以深入洞察创作者如何演绎挑战赛与爆款梗。标准化结果汇总了文案、创作者信息、视频播放链接以及点赞和播放指标，全面呈现音频聚合下的衍生内容。
主要特性
- 基于原声的视频聚合提交一个或多个数字 sound clip ID，批量拉取在该音频下发布的公开视频流。
- 创作者与内容上下文获取包含创作者 handle、昵称、完整视频文案、Hashtag 标签和@提及的标准化对象。
- 互动表现对比采集播放数、点赞数、评论数、分享数和收藏数，方便分析同款音频不同视频的热度差异。
- 媒体资源链接获取高清封面图和视频播放源地址，并附带分辨率宽高与时长数据。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
music_ids | 必填 | 要采集同款视频的 TikTok 原声数字 clip ID 数组。 |
results_limit | 可选 | 每个原声 ID 返回的视频数量上限；默认为 100，支持 1 到 2,000 的整数。 |
如何使用
提交原声 clip ID 列表作为异步任务，并通过游标分页读取标准化视频流。
- 在 music_ids 中传入一个或多个数字 clip ID，并选填 results_limit（最高 2,000）。
- 向 /v1/tiktok/song-videos 发送 POST 请求。
- 轮询 /v1/tasks/{task_id} 直至状态变为 succeeded。
- 从 data.results.items 中读取结果，若 has_more 为 true 可继续使用 next_cursor 分页。
curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"music_ids":["7439295283975702544"],"results_limit":20}'
# 轮询 GET /v1/tasks/{task_id}，解析 data.results.items 中的同款视频。最佳使用场景
- 品牌定制音频传播复盘： 监测品牌推广曲或专属 BGM 在全平台的 UGC 扩散广度及头部参与创作者作品。
- 热门玩法创意拆解： 分析同一背景音乐下不同创作者采用的拍摄手法、运镜转场或剧本构思模式。
- 爆款同款短视频选品： 挖掘在特定热门声音下获得极高播放和点赞的带货视频，为选品和素材制作提供参考。
使用建议
- 可通过 TikTok Song 接口或音乐分享链接 URL 尾部轻松提取纯数字的 music_id。
- 返回的视频顺序依照平台原声页面的公开视频排序（通常偏向热门或近期）。
- results_limit 对传入的每个原声独立生效，支持在一次任务中批量处理多个原声。
- 每条视频返回对象中 extra.clip_id 会记录该视频归属的原声输入 ID，方便做数据关联。
相关 API
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
- TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
- TikTok Search API — 按关键词搜索公开视频，并支持排序和发布时间筛选。
- TikTok Comment Replies API — 使用 TikTok 视频 URL 和 comment_id 采集一条已知评论下的公开回复，返回作者、互动、时间和父评论上下文。
- TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料，并保留来源上下文和支持的指标。
- TikTok Following List API — 采集 TikTok 账号公开可见的关注对象，返回标准化身份、简介、可见指标和来源账号信息。
- TikTok User Videos API — 按 username 采集公开个人资料视频，返回文案、创作者、媒体、时间、互动和来源账号上下文。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间，返回状态、主播信息、封面和受众计数。
- TikTok Trending Feed API — 按 region 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。
- TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。
- TikTok Search Users API
- TikTok Song API