YouTube 视频信息 API 概览

本接口用于获取指定 YouTube 视频的详细信息。支持以下 API 方法与路径：

• 标准任务提交：POST /v3/serp/youtube/video_info/task_post/
• 标准任务结果获取：GET /v3/serp/youtube/video_info/task_get/advanced/
• 实时高级查询：POST /v3/serp/youtube/video_info/live/advanced/
• 已完成任务列表：GET /v3/serp/youtube/video_info/tasks_ready/

功能说明

YouTube 视频信息 API 基于 YouTube Video Info 搜索引擎，为指定视频返回以下数据：

• 视频基本信息
• 视频指标
• 播放与互动指标
• 视频发布频道信息
• 视频在搜索结果中的排名信息

返回结果对应请求中指定的 video_id。如需验证结果与页面的一致性，可使用响应中的 check_url，并在无痕模式下打开该地址进行核验。

> 注意：YouTube SERP API 提供 desktop 设备类型的结果。创建任务时，可指定以下操作系统： > > - Windows > - macOS

排名字段

YouTube SERP API 使用以下字段表示搜索结果排名：

• rank_group：在所属结果分组中的排名。
• rank_absolute：在整个 SERP 结果中的绝对排名。

例如，某个可能在特定结果分组中排名第 2，但在整个搜索结果页面中排名第 8。

可用功能

YouTube Video Info Advanced

POST /v3/serp/youtube/video_info/live/advanced/ 用于实时获取指定 YouTube 视频的详细数据：

• 视频详细信息
• 视频指标
• 视频所属频道信息
• 排名与 SERP 数据

数据获取方式

本接口支持标准任务和实时查询两种方式。不同方式在响应速度、调用流程和费用方面有所区别。

实时方式

实时方式适用于需要立即获取结果的场景：

POST https://api.seermartech.cn/v3/serp/youtube/video_info/live/advanced/

该方式会在单次请求中提交查询并返回结果，无需分别调用任务提交接口和任务结果获取接口。

标准任务方式

标准方式适用于不要求实时返回结果的场景，通常更低的调用成本。使用流程如下：

1. 调用任务提交接口创建任务。
2. 等系统完成数据采集。
3. 调用任务结果接口获取指定任务的结果。

提交任务：

POST https://api.seermartech.cn/v3/serp/youtube/video_info/task_post/

获取任务结果：

GET https://api.seermartech.cn/v3/serp/youtube/video_info/task_get/advanced/

如果需要批量提交多个任务，可调用任务完成列表接口获取已完成任务的 id，再针对每个任务调用结果接口：

GET https://api.seermartech.cn/v3/serp/youtube/video_info/tasks_ready/

回调通知

创建任务时，可以以下回调地址：

• pingback_url：任务完成后通知指定地址。
• postback_url：任务完成后将结果发送到指定地址。

使用 postback_url 时，结果获取功能支持 advanced。

请求限制

当前每分钟最多可发送：

• POST 和 GET 请求合计不 2000 次；
• 每个 POST 请求最多 100 个任务。

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

优级与计费

实时方式会立即返回结果，因此通常适用于时效性要求较高的业务调用成本也相对较高。

标准任务方式支持两种执行优级：

1. Normal：普通优级；
2. High：高优级。

费用取决于以下因素：

• 所选数据获取方式；
• 任务执行优级；
• 请求中的参数；
• 提交的任务数量。

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

认证示例

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/youtube/video_info/live/advanced/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "video_id": "YOUR_VIDEO_ID",
      "os": "windows"
    }
  ]'

字段说明

字段	说明
video_id	要查询的 YouTube 视频 ID。返回结果与该视频 ID 一一对应。
os	目标操作系统，可使用 windows 或 macos。
check_url	用于核验采集结果的页面地址，建议在无痕模式下访问。
rank_group	素在所属 SERP 结果分组中的排名。
rank_absolute	素在整个 SERP 结果中的绝对排名。
pingback_url	任务完成后接收通知的回调地址。
postback_url	任务完成后接收完整结果的回调地址。使用该字段时支持 advanced 结果功能。

实用场景

• 监测指定视频的播放与互动指标，帮助团队评估视频表现并优化选题与发布策略。
• 批量采集竞品频道的视频数据，支持竞品分析、频道对比和增长策略制定。
• 跟踪视频在 SERP 中的排名变化，及时发现排名波动并调整视频标题、描述和结构。
• 构建 YouTube表现看板，集中展示视频指标与频道信息，为 SEO 和运营决策提供数据支持。
• 通过回调接收任务结果，将视频数据自动同步到报表、数据仓库或监控系统中。