douyin/
video-comments

通过一个 douyin.com 或 iesdouyin.com 直接视频 URL 采集一页公开 Douyin 视频评论,返回标准化正文、作者、关系、时间和可见互动字段。

Douyin Video Comments API

直接视频 URL
单个来源页
CommentItem 1.0
每次请求 0.1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Douyin Video Comments

Douyin 视频评论是附在视频下方的公开回应,包含正文、作者身份、发布时间信息以及可见点赞或回复信号。这些记录可用于审阅受众反馈、梳理评论关系和比较不同采集时点的互动情况。

Douyin Video Comments API 主要特性

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

Douyin Video Comments API 参数

参数必填描述
url必填必填的公开 URL,主机名须为 douyin.com、iesdouyin.com 或其子域,路径须包含 /video/ 和随后的数字视频 ID。
results_limit可选可选的 1 到 20 整数。省略时默认使用 20;当前集成只请求第一个来源页。

如何使用 Douyin Video Comments API

设置一个直接公开 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

Douyin Video Comments API 最佳使用场景

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

Douyin Video Comments API 使用建议

  • 提交前先在浏览器中把分享或重定向链接解析为最终的 /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 前应转义正文。

除了 Douyin Video Comments API,需要其他类型的 Douyin 公开数据时,可以使用以下 API。

探索其他平台

还可以将 Douyin 数据与其他已支持社交平台的公开数据结合使用。

Douyin Video Comments API — 常见问题

Douyin Video Comments API 是一个从带数字视频路径的 Douyin 视频 URL 采集一页公开视频评论的接口,返回标准化正文、作者、关系、时间以及可见点赞或回复数量。

url 的主机名必须是 douyin.com、iesdouyin.com 或其子域,路径必须包含 /video/ 和随后的数字 ID。个人资料、搜索和其它非视频路径会被拒绝。

results_limit 接受 1 到 20 的整数,默认值为 20。任务只请求一个来源页,因此不会继续采集更多来源页。

CommentItem 1.0 包含基础身份和时间字段,以及 text、author、parent_id、post_id,还有带 likes_count 和 replies_count 的 metrics。来源未提供的选填字段保持为空。

它不会另外请求回复分页。来源行可能提供 replies_count 和 parent_id,但这些字段并不表示任务采集了回复正文。

next_cursor 属于 GET /v1/tasks/{task_id},只在任务成功后对 SocQ 已存储记录分页,不会请求下一个 Douyin 来源页。

每个成功任务固定消耗 0.10 SocQ 积分,与 results_limit 或返回条目数无关;失败任务遵循运行时退款路径。