TikTok Videos API

TikTok Videos

主要特性

• 批量视频 URL 查询批量把 TikTok 视频链接转换成统一内容记录。
• 稳定的视频身份通过视频 ID 和规范 URL 整理同一素材的身份与来源。
• 内容与创作者字段提取文案、语言、发布时间、作者、时长和封面等基础信息。
• 创意上下文字段汇集标签、提及、音乐与内容状态，支持创意结构拆解。
• 时间点指标将播放和各类互动计数与 collected_at 组合成表现快照。

参数

如何使用

把收藏夹、报表或业务系统中的视频链接变成可分析的内容清单。

1. 汇总待分析的视频链接，按具体视频 URL 规范化并去重。
2. 把 urls 数组 POST 到 /v1/tiktok/videos，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务进入 succeeded 或 failed 状态。
4. 从 data.results.items 读取视频记录；如果 has_more 为 true，则继续传入 next_cursor。

curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传入 next_cursor

最佳使用场景

• 内容模式分析： 结合文案、标签、提及、音乐和时长，对比选定视频中反复出现的内容元素。
• 活动视频报表： 为指定活动素材保存播放与互动快照，统一比较参与视频的表现。
• 视频资产目录： 用视频 ID、规范 URL、封面、作者和发布时间建立可搜索的内容索引。
• 选题与风格分类： 依据文案、语言、标签和音乐信息，为视频添加主题、形式与受众标签。

使用建议

• 按 id 合并重复素材，并保留 url 供审阅人员跳转原视频。
• 把 published_at 作为发布时间，把 collected_at 作为指标快照时间，分别存储。
• 将 caption、hashtags、mentions 和 music 组合为可用于搜索与分类的内容特征。
• views 字段存在且大于零时，再用它作为点赞、评论和分享占比的分母。
• 把 Comments 数据接到同一视频 id 下，同时查看素材表现与受众反馈。
• 批量分析前先确定统一采集时点，让同组视频的互动指标更便于横向比较。

相关 API