YouTube 视频评论 API 概览

本接口用于获取指定 YouTube 视频的热门评论。通过 YouTube 视频评论搜索能力，您可获得目标视频的前 20 条评论、评论信息及评论指标。返回数据与请求中指定的 video_id 对应的视频。

可使用任务结果中的 check_url 在浏览器无痕模式下打开验证页面，确认返回与目标视频一致。

> **注意：**YouTube SERP 数据支持 desktop 设备类型。创建任务时，可通过 os 指定操作系统为 Windows 或 macOS。

SERP 结果中以下排名字段：

• rank_group：结果在所属组中的位置。
• rank_absolute：结果在整个搜索结果页中的位置。

对于视频评论结果，这两个字段可用于识别评论在页面结果结构中的相对位置和局位置。

可用功能

YouTube 视频评论高级接口

/v3/serp/youtube/video_comments/live/advanced/

该接口实时返回指定 YouTube 视频的前 20 条热门评论，并提供以下信息：

• 评论；
• 评论信息；
• 评论点赞等指标；
• 评论在结果页中的排名信息。

数据获取方式

本接口支持两种结果获取模式：实时模式（Live）和标准模式（Standard）。

实时模式（Live）

实时模式适用于需要立即获得视频评论数据的场景。

通过以下接口一次请求即可提交任务并同步获取结果：

/v3/serp/youtube/video_comments/live/advanced/

实时模式无需分别调用创建任务和获取任务结果接口，但相较标准模式成本更高。

标准模式（Standard）

标准模式适用于不要求实时返回结果的批量采集场景，整体成本通常更低。

标准模式的基本流程如下：

1. 调用任务创建接口提交评论采集任务：

   /v3/serp/youtube/video_comments/task_post/

2. 等本平台完成任务处理。

3. 调用高级任务结果接口获取数据：

   /v3/serp/youtube/video_comments/task_get/advanced/

如果一次提交了多个任务，可通过以下接口获取已完成任务的 ID 列表：

/v3/serp/youtube/video_comments/tasks_ready/

然后针对每个已完成任务的 ID，调用：

/v3/serp/youtube/video_comments/task_get/advanced/

获取对应的视频评论结果。

回调通知

创建标准任务时，您还可以以下回调字段：

• pingback_url：任务完成后，本平台向该地址发送完成通知。
• postback_url：任务完成后，本平台将任务结果直接推送至该地址。

> **注意：**使用 postback_url 时，结果获取支持 advanced 功能类型。

任务优级与计费

实时模式会在请求期间同步返回结果，因此通常最高的处理优级和成本。

标准模式支持以下两种任务优级：

1. normal：普通优级，适合常规批量任务。
2. high：高优级，适合对返回速度要求较高的任务。

depth 对费用的影响

depth 用于指定需要获取的结果深度。默认深度会增加任务费用。

例如，默认 depth 为 20，费用按每 20 条结果计费：

• 设置 "depth": 20：按 20 条结果计费；
• 设置 "depth": 30：将按两个 20 条结果区间计费，即按 40 条结果计费。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

接口调用限制如下：

平台限流以认证说明中的 30/60/120 次/分钟规则为准/分钟；

• 单次 POST 请求最多可 100 个任务。

如需提高调用额，请联系本平台技术支持。

使用建议

• 需要立即查看单个视频评论时，使用 /v3/serp/youtube/video_comments/live/advanced/。
• 需要批量采集多个视频的评论时，使用标准模式，通过 /v3/serp/youtube/video_comments/task_post/ 创建任务，再通过任务结果接口获取数据。
• 对于大规模批量任务，建议 pingback_url 或 postback_url，减少轮询任务状态的请求量。
• 在设置较大的 depth 前，应评估业务需求及相应计费影响。

实用场景

• 监测品牌视频口碑：采集品牌官方频道或合作达人视频下的热门评论，快速识别用户态度、常见反馈及潜在舆风险。
• 分析竞品反馈：追踪竞品视频评论中的高频问题、用户需求和产品评价，为策略及产品优化提供依据。
• 筛选高价值互动线索：提取热门评论及信息，发现高互动用户、潜在客户或适合二次触达的社区成员。
• 评估视频效果：结合评论数量、点赞等评论指标，衡量视频主题、标题或形式对受众互动的影响。
• 挖掘选题机会：分析用户在评论区提出的问题、争议点和补需求，形成后续 SEO、视频脚本或 FAQ 选题。