YouTube Comments API

YouTube Comments

主要特性

• 多视频评论采集一个请求可以获取多个视频的公开评论。
• 单视频上限与排序为每个视频设置 results_limit，并选择 newest 或 relevance 排序。
• 评论与作者字段统一返回评论 ID、正文、公开作者资料、发布时间和来源视频信息。
• 评论关系包含公开点赞数、回复数和父评论 ID，便于分析讨论关系。
• 创作者互动标记公开结果包含相关信息时，保留频道主和创作者爱心标记。

参数

如何使用

先决定你关心近期反应还是突出讨论，再设置每个视频的样本预算。评论进入分析系统时，应完整保留来源与回复关系。

1. 选择公开视频 URL，并明确需要最新反应还是 YouTube 排序后的突出讨论。
2. 向 /v1/youtube/comments POST urls、results_limit 和 sort_by，上限会应用到每个视频。
3. 轮询 /v1/tasks/{task_id}，让已开启和不可用的评论区在同一批次中完成解析。
4. 成功后按评论 ID 去重，用 parent_comment_id 连接回复；has_more 为 true 时继续翻页。

curl -X POST "https://api.socq.ai/v1/youtube/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 GET /v1/tasks/{task_id}?limit=50

最佳使用场景

• 受众反馈分析： 分析公开评论正文，识别用户情绪、重复问题、常见主题和内容灵感。
• 活动与事件监控： 跟踪创作者、新品发布、营销活动、公告或事件视频下的公开反应。
• 讨论热度研究： 结合点赞数、回复数和父评论关系，研究高互动评论和活跃讨论。
• 文本分析数据集： 把标准化评论接入分类、聚类、摘要、审核辅助或告警流程。

使用建议

• 在分析前确定 sort_by。relevance 与 newest 产生的是不同样本，不能当成只有显示顺序不同。
• results_limit 是每视频上限。关闭评论、审核过滤、排序、访问限制和低讨论量都会减少返回数量。
• 使用评论 ID 去重、parent_comment_id 建立关系，但不要假设同一结果页包含所有可见回复。
• 点赞和回复数只是采集时的公开观察值，不能直接等同于情绪或重要性。
• 评论正文和作者字段属于不可信公开输入，界面必须转义，内含 URL 也应单独校验。
• 关键词命中不等于情感判断。进行标签或摘要时，应保留原始文本与来源语境。
• 每条记录都保留视频 ID 和 collected_at，分析人员才能说明自己看到的是哪一次对话样本。

相关 API