按视频 ID 查询 TikTok 视频详情
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过路径参数 video_id 查询一条 TikTok 视频的详情。请将纯数字视频 ID 作为字符串传入，不要填写用户名或完整的视频链接。文档中的默认值为 7468030505628224790，该值仅作输入示例，不代表对应视频始终可用。此查询未记载分页参数或请求体输入。 已观察到的成功结果中，status 为 ok，data.status_code 为 0，data.aweme_detail 对象包含 aweme_id、author.unique_id 和 create_time。该次结果的视频 aweme_id 为 7697307919943060767，author.unique_id 为 khaby.lame，create_time 为 1792169181；同时还观察到了视频描述、9500 毫秒的视频时长、音乐信息和互动统计。这些信息仅说明一次成功查询的情况，不保证每个视频 ID 都会返回同样的内容。 现有资料未提供完整响应示例，也未列明描述、时长、音乐和互动统计的嵌套字段，无法确定音乐 ID 的具体属性名，或保证返回可播放的媒体链接。提取这些信息或衔接音乐查询前，请先核对实际返回对象。视频 ID 应始终按字符串处理，以免丢失数字精度。互动数据仅代表查询时的快照，建议单独记录 fetched_at，不要将其与视频创建时间 create_time 混用。获取视频元数据不授予下载或内容再利用的权利，也不提供私密账号访问能力，不能替代创作者官方数据分析。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/tiktok/video-data API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/video-data?key=<API_KEY>&video_id=7468030505628224790'
查询结果
使用场景
- 为选定的 TikTok 信息流视频 ID 补充详情记录及已观察到的作者归属，并在存储和数据关联过程中始终保留字符串形式的视频 ID。
- 利用创建时间、可用的视频描述和时长信息比较少量指定视频，为每次详情查询单独记录 fetched_at。
- 检查视频返回的音乐信息，在确认音乐 ID 的实际属性名后提取标识，用于后续的独立音乐查询。
- 定时采集可用的视频互动计数，积累快照历史；保存前核对实际返回的统计字段，不预设固定的统计结构。
常见问题
video_id 应填写 TikTok 视频链接，还是只填写视频 ID？
只需在路径中传入字符串形式的视频 ID。文档中的默认值和占位示例均为 7468030505628224790。完整 TikTok 视频链接或用户名不是此接口记载的输入格式，长数字 ID 也不应转换为可能丢失精度的数值类型。
目前实际观察到了哪些视频详情字段？
成功测试的结果摘要显示，status 为 ok，data.status_code 为 0，data.aweme_detail 中包含 aweme_id、author.unique_id 和 create_time。还观察到了视频描述、9500 毫秒的视频时长、音乐信息和互动统计，但这些信息的嵌套字段名未逐一列明。现有资料没有提供可用于确定完整结构的响应示例。
成功测试使用的就是文档中的默认视频 ID 吗？
不是。文档中的默认值为 7468030505628224790，而成功测试返回的视频 ID 为 7697307919943060767，author.unique_id 为 khaby.lame，create_time 为 1792169181。不能据此认定默认视频目前仍可查询。
能从视频的音乐信息中获取音乐 ID 吗？
视频详情中已观察到音乐信息，如果其中包含标识，就可以用于衔接视频与音乐查询。但现有证据尚未确定该标识的具体属性名。请先检查实际返回的音乐对象，再提取 ID 进行独立音乐查询；不要假设每条视频都包含可用的音乐信息。
互动统计是历史数据或创作者官方分析数据吗？
不是。可用的互动数值应视为所查询视频在获取时的快照，不是完整历史记录，也不是创作者官方分析报告。每次查询应单独记录 fetched_at，将其与视频的 create_time 区分开，并在保存和比较前核对实际返回的计数字段。
此查询保证返回永久可播放的视频链接吗？
不保证。现有证据无法保证会返回可播放的媒体链接，也无法保证链接的有效期。获取元数据不意味着获得下载、再分发或内容再利用的权利。