Douyin Video Comments API

Douyin Video Comments

主要特性

• 直接定位视频从一个公开 douyin.com 或 iesdouyin.com URL 中解析数字视频 ID，其路径须包含 /video/{numeric_id}。
• 范围明确的单页采集从第一个来源页请求最多 20 条评论，并通过 results_limit 在 1 到 20 之间控制存储的结果子集。
• 规范评论上下文以 CommentItem 1.0 返回正文、作者身份、视频与父级关系、发布和采集时间，以及可见点赞或回复数量。

参数

如何使用

设置一个直接公开 Douyin 视频 URL，提交异步任务，再读取该任务保存的标准化评论。

1. 将 DOUYIN_VIDEO_URL 设置为 douyin.com 或 iesdouyin.com 上带有 /video/{numeric_id} 路径的公开视频 URL。
2. 将 url 和可选 results_limit POST 到 /v1/douyin/video-comments，并保存 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
4. 读取 data.results.items；仅当 has_more 为 true 时使用 next_cursor 继续读取 SocQ 已存储记录。

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

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

最佳使用场景

• 受众反馈审阅： 结合评论正文、作者身份以及可见点赞或回复数量，审阅一个已知公开视频收到的回应。
• 评论关系梳理： 使用 post_id 和 parent_id 把返回评论关联到来源视频及来源提供的父级引用。
• 互动快照比较： 比较选定视频或不同采集时点的可见评论信号，同时把 collected_at 保留为观察时间。

使用建议

• 提交前先在浏览器中把分享或重定向链接解析为最终的 /video/{numeric_id} URL，确保主机名和路径校验能够通过。
• 省略 results_limit 即请求 20 条；只需要单个返回来源页的一部分时，可设置更小的整数。
• 复用原 task_id，并仅在 has_more 为 true 时跟随 next_cursor；该 cursor 只读取已存储记录，不会再请求一个来源页。
• 使用评论 id 作为主要去重键；来源行没有关系信息时，允许 parent_id 或 post_id 保持为空。
• 将作者详情、published_at 和单项指标视为选填字段，并用 collected_at 标记每次结果快照的时间。
• 公开视频评论属于用户生成内容，插入 HTML 前应转义正文。

相关 API