按音乐 ID 查询 TikTok 音频信息
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填路径参数 music_id 查询一条 TikTok 音乐或音频记录的元数据。请传入音频 ID，而非视频 ID、曲名或完整链接，文档示例为 7443916074024913686。一次使用其他音频 ID 的成功测试返回 status=ok，data 中包含 status_code=0、msg=success 和 music_info。已观察到的 music_info 字段包括 id_str（音频标识）、title、author、album、owner_handle、owner_id、owner_nickname、duration（秒）、user_count（报告的使用次数）、play_url，以及 cover_large、cover_medium、cover_thumb。play_url 对象中已观察到 uri、url_list、width、height、data_size 和 file_hash。采样的原创音频记录中 duration=9、user_count=30；这些只是观察值，不是固定数值，也不保证对应文档中的示例 ID。元数据和播放链接无法证明音频对应某首商业发行歌曲，也不代表获得下载许可或复用权利。请将 user_count 视为返回的音频使用量指标，而非视频播放量、独立听众数或完整的使用情况统计。音频链接的可用性和有效期均无保证；此接口不返回使用该音频的视频分页列表。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/tiktok/music-data API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/music-data?key=<API_KEY>&music_id=7443916074024913686'
查询结果
使用场景
- 从视频记录中提取正确的音乐标识后，为视频审核资料补充所用音频的标题与所属账号名。
- 维护以 music_info.id_str 为键的音频资料表，明确区分原创音频标识、视频 ID 与自由填写的歌曲名称。
- 在剪辑或音画同步流程中，先统一单位，再将以秒计的音频时长与另行采集的视频时长进行比较。
- 以 user_count 报告值建立带采集时间的音频使用观察记录，并注明其并非播放量或独立听众总数。
- 制作音频使用前的版权审核清单，将可获取的播放元数据与授权判断分开处理，再决定是否下载或复用。
常见问题
music_id 和 TikTok 视频 ID 是同一个标识吗？
不是。此接口需要音乐或音频记录的标识。视频 ID、音频标题和完整链接均不属于文档说明的输入格式。
响应中验证过哪些音频元数据？
成功样本中包含 music_info.id_str、title、author、album、owner_handle、owner_id、owner_nickname、duration、user_count、play_url 和封面对象。响应外层包含 status=ok、data.status_code=0 和 data.msg=success。该样本使用的音频 ID 与文档示例不同，因此不能把样本中的数值归到示例 ID 名下。
duration 使用什么单位？
现有证据表明音频时长以秒为单位，样本值为 9。如果视频时长以毫秒计，必须先换算单位，再进行比较。
user_count 是播放量或独立听众数吗？
目前没有证据支持这种解释。请将其视为报告的音频使用次数，已观察到的样本值为 30。保存时应同时记录采集时间，不要将其展示为视频播放量、独立听众数或完整的使用量统计。
有 play_url 就可以下载或复用音频吗？
不可以据此认定。已观察到的 play_url 对象包含 url_list 等播放位置元数据，但其存在不代表取得许可或复用权利。链接的可用性和有效期也无保证。
此接口会列出使用该音乐的所有视频吗？
不会。这是针对单个音乐 ID 的元数据查询接口，没有文档说明的分页输入，也不提供该音频对应的完整视频列表。