YouTube Comment Replies API

YouTube Comment Replies

主要特性

• 稳定的评论引用提交公开视频 URL 和对应的父评论 ID，由 SocQ 在内部解析当前可用的回复 continuation token。
• 回复与作者标准化记录返回回复 ID、公开正文、关联 URL、发布时间，以及标准化作者或频道身份。
• 会话与创作者信息在同一记录中保留可见点赞、嵌套回复数、父评论和视频关系，以及频道主或创作者爱心标记。
• 有边界的续页采集继续读取后续来源令牌，按回复 ID 去重，并在达到所选上限、公开会话结束或 100 页上限时停止。

参数

如何使用

把稳定的视频 URL 和父评论 ID 作为异步任务提交，再从完成的任务中获取标准化回复记录。

1. 选择公开 YouTube 视频 URL，以及该视频返回的一条顶层评论 ID。
2. 向 /v1/youtube/comment-replies POST url、comment_id 和 results_limit。
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 继续请求该任务。

curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

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

最佳使用场景

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

使用建议

• 确保视频 URL 与顶层评论 ID 属于同一视频，使回复会话与来源视频保持一致。
• SocQ 会在内部解析当前 continuation token；上游 token 过期时可使用同一稳定引用重试。
• 区分来源评论 ID 与 GET /v1/tasks/{task_id} 返回的 cursor：前者选择 YouTube 回复会话，后者只用于翻阅已保存的任务结果。
• 根据预期会话规模设置 results_limit，但应把它视为上限，因为公开可见性和会话结束都可能减少结果数。
• 按回复 ID 去重，并在关联来源评论时保留 parent_comment_id、video_id 和 extra.reply_token。
• 允许作者、时间、指标和创作者标记为空；在其它界面展示公开回复正文前进行转义处理。

相关 API