YouTube SERP API 概览

POST /v3/serp/youtube/organic/task_post

YouTube SERP API 用于根据指定的或视频 ID，结合搜索引擎类型、地域、语言和设备操作系统，获取 YouTube 搜索结果及视频数据。

支持的搜索引擎类型

本平台支持以下 YouTube 搜索引擎类型：

类型	说明	参考路径
YouTube Organic	获取 YouTube 自然搜索结果	`/v3/serp/youtube/organic/`
YouTube Video Info	获取指定视频的详细信息	`/v3/serp/youtube/video_info/`
YouTube Subtitles	获取指定视频的字幕信息	`/v3/serp/youtube/video_subtitles/`
YouTube Comments	获取指定视频的评论信息	`/v3/serp/youtube/video_comments/`

返回结果由以下参数决定：

keyword：搜索。
video_id：YouTube 视频 ID，适用于视频信息、字幕和评论等接口。
搜索引擎类型。
language：搜索语言。
location：搜索地域。
设备类型或操作系统。

本平台会尽可能准确地模拟指定地域和搜索环境，使返回结果接近任务创建时对应参数下的搜索结果。响应中的 check_url 可用于检查搜索页面。建议在无痕模式下打开该地址，以减少登录状态、历史记录和个性化设置对验证结果的影响。

系统不会纳用户偏好、搜索历史及个性化搜索因素，因此返回的 SERP 结果不会体现这些因素。

设备与操作系统支持

除 YouTube Organic 外， YouTube SERP API 类型返回桌面端结果。

创建任务时，可指定以下操作系统：

Windows
macOS

YouTube Organic 同时支持：

desktop
mobile

API 函数

所有 YouTube API 搜索引擎类型均支持 advanced 函数。

advanced 函数用于返回完整的搜索结果概览及视频数据，适合需要获取完整 SERP 结构和视频字段的场景。

如果通过 postback_url 接收结果，数据检索时支持使用 advanced 函数。

数据获取方式

YouTube SERP API 支持以下两种任务执行方式。

Live

Live 方式适合需要即时获取结果的场景：

请求提交后直接返回任务结果。
无需再单独调用任务查询接口。
结果返回速度更快。
相比 Standard 方式，通常更高的调用成本。

Standard

Standard 方式适合不要求实时返回结果的场景：

通过 POST 接口创建任务。
等任务执行完成。
通过 GET 接口获取任务结果。

该方式通常更经济，但需要分别发起任务创建请求和结果获取请求。

Pingback 与 Postback

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

pingback_url：任务完成后通知调用方。
postback_url：任务完成后将结果直接发送到指定地址。

使用 postback_url 时，数据返回函数支持 advanced。

Tasks Ready 与 Task GET

如果使用 Standard 方式，且未设置 pingback_url 或 postback_url，可以按以下流程获取结果：

调用 Tasks Ready 接口，获取已完成但尚未读取的任务 ID 列表。
使用 Task GET 接口，根据任务 ID 获取结果。

请求限制

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

每个 POST 请求最多 100 个任务。
如需提高调用限制，请联系本平台技术支持。

建议根据批量任务量合理控制请求频率和单次请求中的任务数量。

计费规则

YouTube SERP API 的费用取决于数据获取方式、任务优级、搜索引擎类型及请求参数。

任务优级

Standard 方式支持以下优级：

Normal：普通优级。
High：高优级，通常更快的任务执行速度。

Live 方式用于实时返回结果，通常对应最高的请求成本。

结果数量与计费

对于以下类型：

YouTube Organic
YouTube Comments

系统按每组 20 条 SERP 结果计费。

如果将 depth 设置为高于默认值，任务成本会按结果数量增加。例如：

默认 depth 为 20。
设置 "depth": 30 时，计费结果数量按 40 条计算。
该任务费用将按两组 20 条结果计算。

对于以下类型：

YouTube Video Info
YouTube Subtitles

每次 API 调用均按标准 SERP 价格的 3 倍计费，不受返回结果数量影响。

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

认证方式

请求时使用 Bearer Token 进行认证：

http

Authorization: Bearer smt_live_YOUR_KEY

示例：

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/youtube/organic/task_post \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "seo tools",
      "location_code": 2840,
      "language_code": "en",
      "device": "desktop",
      "os": "windows",
      "depth": 20
    }
  ]'

以上示例用于说明请求格式，字段请以对应搜索引擎类型的接口文档为准。

##测试

可通过本平台的沙盒环境测试 YouTube SERP API：

/v3/appendix/sandbox/

沙盒用于验证请求结构和接口调用流程，正式环境的任务执行及计费规则以响应为准。

实用场景

监控排名：批量获取指定的 YouTube 自然搜索结果，分析视频排名变化并优化策略。
评估竞品视频表现：查询竞品视频的标题、频道及搜索展现信息，识别覆盖的和优势。
构建视频数据画像：调用 Video Info 获取视频详细数据，为选题、视频评分和竞品分析提供依据。
采集视频字幕：获取目标视频字幕，用于主题提取、分析和多语言研究。
分析用户评论反馈：批量获取视频评论，识别用户点、常见问题和潜在需求。

YouTube SERP API 概览 ​

支持的搜索引擎类型 ​

设备与操作系统支持 ​

API 函数 ​

数据获取方式 ​

Live ​

Standard ​

Pingback 与 Postback ​

Tasks Ready 与 Task GET ​

请求限制 ​

计费规则 ​

任务优级 ​

结果数量与计费 ​

认证方式 ​

实用场景 ​