YouTube 视频字幕 API 概览

YouTube 视频字幕接口用于获取指定 YouTube 视频中的字幕、字幕语言及字幕在视频中的时间范围等信息。实时查询主接口为 POST /v3/serp/youtube/video_subtitles/live/advanced/；异步标准模式则通过创建任务接口和结果获取接口完成查询。

本接口基于指定的 video_id 返回结果。可使用响应中的 check_url，在浏览器无痕模式下打开并核对页面数据，确认返回与目标视频一致。

> 注意：YouTube SERP 数据支持 desktop 设备类型。创建任务时可指定以下操作系统： > > - windows > - macos

返回结果说明

字幕结果通常以下信息：

信息	说明
字幕文本	视频中对应时间段的字幕
字幕语言	字幕所属语言或语言代码
时间范围	字幕在视频中的开始时间、结束时间或持续时长
视频信息	与指定 video_id 对应的视频页面数据
check_url	可用于人工复核结果来源页面的地址

SERP 结果中可能以下排名字段：

字段	说明
rank_group	结果在所属分组中的位置
rank_absolute	结果在整页所有 SERP素中的绝对位置

rank_group 适合判断结果在同类模块中的排序，rank_absolute 适合判断结果在整个搜索结果页中的局位置。

可用接口

实时高级查询

POST /v3/serp/youtube/video_subtitles/live/advanced/

实时模式在单次请求中完成数据采集并直接返回结果，适用于需要立即获取指定视频字幕的场景。

特点：

• 无需创建任务再轮询结果；
• 返回指定视频的字幕、语言及时间数据；
• 适合在线字幕分析、即时审核和实时数据展示；
• 实时模式的计费通常高于异步标准模式。

标准异步查询

标准模式适用于无需实时返回结果、希望降低采集成本的业务。

处理流程如下：

1. 通过 POST /v3/serp/youtube/video_subtitles/task_post/ 创建字幕采集任务；
2. 等任务完成；
3. 通过 GET /v3/serp/youtube/video_subtitles/task_get/advanced/ 获取单个任务结果。

如需批量处理多个视频，可调用以下接口获取已完成任务 ID：

GET /v3/serp/youtube/video_subtitles/tasks_ready/

随后使用任务结果接口逐个获取字幕数据。

回调通知

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

字段	说明
pingback_url	任务完成后向指定地址发送完成通知。收到通知后，需再调用结果接口获取数据。
postback_url	任务完成后直接将结果推送到指定地址。使用该字段时，结果获取类型支持 advanced。

对于无需主动轮询任务状态的系统，建议使用 postback_url 接收完成后的字幕结果。

请求限制

接口调用频率限制如下：

限制项	限制值
平台限流以认证说明中的 30/60/120 次/分钟规则为准
单次 POST 可提交的任务数	最多 100 个

如有更高并发或批量采集需求，请联系技术支持调整限额。

执行方式与计费

本接口支持以下执行方式：

方式	说明
实时模式（Live）	单次请求直接返回结果，适合对时效要求高的场景，通常费用最高。
标准模式（Standard）— 普通优级	异步执行，适合常规批量任务。
标准模式（Standard）— 高优级	异步执行速度更快，适合对完成时效有要求的任务。

费用取决于执行方式、任务优级及请求参数。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

选择建议

• 需要在用户请求期间立即展示字幕时，使用实时高级查询接口。
• 需要批量提取大量视频字幕、且可接受延迟时，使用标准异步模式。
• 需要在任务完成后自动接收结果时，为标准任务 postback_url。
• 需要管理大量已完成任务时，使用 tasks_ready 获取任务 ID 列表，再按任务获取结果。

实用场景

• 提取视频字幕文本：批量获取竞品或行业视频的字幕，为研究、脚本拆解和主题归纳提供原始文本数据。
• 分析视频覆盖：将字幕按时间段拆分后提取高频词和实体词，评估视频对目标及长尾主题的覆盖程度。
• 监测竞品更新：定期抓取指定频道重点视频的字幕，识别新增观点、产品卖点和策略变化。
• 生成视频摘要：基于字幕文本自动构建章节摘要、要点提炼或知识库条目，提升视频的检索与复用效率。
• 评估多语言布局：分析视频可用字幕语言及对应文本，为化投放、翻译优级和区域 SEO 策略提供依据。