YouTube Comment Replies API

YouTube Comment Replies

主要特性

• 按已知会话令牌定位从兼容顶层评论附带的不透明回复 continuation token 开始采集，视频 URL 和评论 ID 不能作为替代输入。
• 回复与作者标准化记录返回回复 ID、公开正文、关联 URL、发布时间，以及标准化作者或频道身份。
• 会话与创作者信息在同一记录中保留可见点赞、嵌套回复数、父评论和视频关系，以及频道主或创作者爱心标记。
• 有边界的续页采集继续读取后续来源令牌，按回复 ID 去重，并在达到所选上限、公开会话结束或 100 页上限时停止。

参数

如何使用

把已知公开评论会话作为异步任务继续读取，再从完成的任务中获取标准化回复记录。

1. 先用公开视频 URL 运行 YouTube Comments，并选择结果中带有 extra.replies_continuation_token 的顶层评论。
2. 将该不透明 continuation_token 和 20 到 2000 的 results_limit POST 到 /v1/youtube/comment-replies。
3. 保留返回的 task_id，并在任务处于 queued、running 或 retrying 时轮询 GET /v1/tasks/{task_id}。
4. 任务成功后读取 data.results.items；当 data.results.has_more 为 true 时，把 data.results.next_cursor 作为 cursor 继续请求该任务。

REPLY_TOKEN='粘贴 extra.replies_continuation_token'

curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"continuation_token\":\"${REPLY_TOKEN}\",\"results_limit\":100}"

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时把 data.results.next_cursor 作为 cursor 继续请求

最佳使用场景

• 已知评论会话还原： 使用回复 ID、parent_comment_id、video_id、URL 和时间，把保存的回应重新连接到指定顶层评论。
• 回复层受众回应审阅： 在一个已知会话中比较公开回复正文、作者身份、可见点赞、嵌套回复数和创作者互动标记。
• 公开讨论数据集准备： 组合标准化回复正文、作者、时间和会话关系，为人工查看或下游文本处理准备记录。

使用建议

• 从对应 YouTube Comments 顶层评论记录的 extra.replies_continuation_token 获取 continuation_token，使回复会话与来源视频保持一致。
• 把 continuation token 当作不透明值原样复制；令牌缺失、过期或被拒绝时，应重新采集顶层评论，不要用视频 URL 或评论 ID 替代。
• 区分来源 continuation_token 与 GET /v1/tasks/{task_id} 返回的 cursor：前者选择 YouTube 回复会话，后者只用于翻阅已保存的任务结果。
• 根据预期会话规模设置 results_limit，但应把它视为上限，因为公开可见性和会话结束都可能减少结果数。
• 按回复 ID 去重，并在关联来源评论时保留 parent_comment_id、video_id 和 extra.reply_token。
• 允许作者、时间、指标和创作者标记为空；在其它界面展示公开回复正文前进行转义处理。

相关 API