Douyin Video Detail API

Douyin Video Detail

主要特性

• 按精确视频链接查询接收 douyin.com、iesdouyin.com 或受支持子域上的一个 URL；如果包含 /video/，其后必须是数字视频 ID。
• 边界明确的单视频结果每个任务只执行一次详情请求，最多保存一条标准化视频，不接受源站分页参数或 results_limit。
• 说明文字与作者上下文在可获得时返回视频文本，以及标准化作者 ID、username、显示名称、主页、头像与账号标记。
• 媒体与时长信息保留可获得的视频或图片地址、预览图、尺寸、媒体时长和标准化 duration_seconds 字段。
• 带时间语义的互动快照把可见点赞、评论、分享、播放和观看数量与 published_at、collected_at 配对，避免将其误解为实时计数器。

参数

如何使用

提交一个符合规则的抖音视频 URL，跟踪异步任务，并在成功后读取已保存的标准化结果。

1. 将 DOUYIN_VIDEO_URL 设为公开视频地址：主机名属于 douyin.com、iesdouyin.com 或其子域；如果包含 /video/，其后必须是数字 ID。
2. 向 /v1/douyin/video-detail POST url 字符串，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或失败；任务未完成时不会返回结果字段。
4. 成功后读取 data.results.items。provider 最多生成一条记录，而 limit 与 next_cursor 属于 SocQ 已存结果读取层。

curl -X POST "https://api.socq.ai/v1/douyin/video-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$DOUYIN_VIDEO_URL\"}"

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化视频

最佳使用场景

• 补全已知视频目录： 为经过确认的抖音视频链接补充标准化标识、说明文字、作者、发布时间、时长、媒体和来源字段。
• 连接发现与详情步骤： 从抖音用户视频或视频搜索记录中保留符合规则的视频 URL，再以该准确地址执行一次聚焦详情查询。
• 准备分时点对比： 按既定节奏保存多次成功结果，并结合 collected_at 比较不同采集时点的公开互动快照。

使用建议

• 为确保服务商能解析出视频，请优先使用受支持主机上的直接公开视频地址，并在存在 /video/ 时保留数字视频 ID。
• 在掌握真实公开视频 URL 前让 Playground 保持为空；此接口不存在可靠的通用默认地址。
• 每个任务只提交一个 URL，并省略 results_limit、cursor 和无关 ID，因为公开请求只接受 url。
• 允许作者、媒体、音频、话题、提及或互动字段为空，不要把未提供值改写为空字符串或 0。
• 用 collected_at 比较互动快照，用 published_at 排列内容时间；两者表达的是不同时间点。
• 如需继续获取视频评论，应把可用且符合格式的视频 URL 传给独立评论接口，不要假设详情任务会自动展开评论。

相关 API