YouTube Transcript API

YouTube Transcript API 获取结构化视频文本

通过 YouTube Transcript API 将视频 URL 转换为转录文本、时间戳和分段 JSON,用于应用、智能体、SEO 内容简报和内容研究工作流程。

免费开始

Free plan available

Uses your SearchVector credits

JSON
{
  "video_id": "sv-demo",
  "language": "en",
  "duration_seconds": 842,
  "segments": [
    {
      "start": 0.0,
      "end": 4.8,
      "text": "Search teams need clean
      video transcripts..."
    }
  ],
  "status": "complete"
}

Developer Friendly

REST-style API with predictable endpoints and clear responses.

Free to Start

Get started for free and scale as your needs grow.

Reliable & Secure

Smart error handling with clear messages for smooth integrations.

使用方法

从视频到 结构化 JSON

1

提供视频 URL

在 API 请求中提交公开可访问的 YouTube 视频 URL。

2

提取并处理

提取和处理视频的转录文本与时间戳。

3

接收结构化 JSON

获取可直接用于应用的结构化 JSON 数据。

200 OK
POST
/dashboard_endpoint
HTTP

请求头

Authorization: Bearer YOUR_API_KEY

请求正文(JSON)

{
  "video_url": "https://www.youtube.com/watch?v=sv-demo-video",
  "language": "en",
  "format": "segments"
}
查看更多
{
  "video_id": "sv-demo",
  "language": "en",
  "duration_seconds": 842,
  "segments": [
    {
      "start": 0.0,
      "end": 4.8,
      "text": "Search teams need clean video transcripts before they summarize, analyze, or repurpose content."
    }
  ],
  "status": "complete"
}
JSON

准备好构建您的应用了吗?

开始提取结构化转录数据,并将其接入您的工作流程。

查看文档
开发示例

实用的请求与响应模式 用于转录 API

从单个视频 URL 开始,处理 JSON 响应,并为字幕不可用的视频做好规划。经过身份验证的转录端点会在 SearchVector 仪表板中提供。

curl 请求

curl -X POST "$SEARCHVECTOR_TRANSCRIPT_ENDPOINT" \
-H "Authorization: Bearer $SEARCHVECTOR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://www.youtube.com/watch?v=sv-demo-video",
"language": "en",
"format": "segments"
}'
 
 

JSON 响应结构

{
"video_id": "sv-demo-video",
"language": "en",
"transcript_available": true,
"segments": [
{
"start": 0.0,
"end": 4.8,
"text": "Search teams use video transcripts to research topics and create content briefs."
}
],
"text": "Search teams use video transcripts to research topics and create content briefs.",
"status": "complete"
}

转录不可用的示例

{
"video_id": "sv-demo-video",
"transcript_available": false,
"status": "unavailable",
"error": {
"code": "transcript_unavailable",
"message": "No transcript is available for the requested video and language."
}
}
 

curl 请求

curl -X POST "$SEARCHVECTOR_TRANSCRIPT_ENDPOINT" \
-H "Authorization: Bearer $SEARCHVECTOR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://www.youtube.com/watch?v=sv-demo-video",
"language": "en",
"format": "segments"
}'
 
 

JSON 响应结构

{
"video_id": "sv-demo-video",
"language": "en",
"transcript_available": true,
"segments": [
{
"start": 0.0,
"end": 4.8,
"text": "Search teams use video transcripts to research topics and create content briefs."
}
],
"text": "Search teams use video transcripts to research topics and create content briefs.",
"status": "complete"
}

转录不可用的示例

{
"video_id": "sv-demo-video",
"transcript_available": false,
"status": "unavailable",
"error": {
"code": "transcript_unavailable",
"message": "No transcript is available for the requested video and language."
}
}
 
为什么使用此 API

使用转录数据 分析视频内容

将 YouTube 转录文本直接接入 SearchVector 的 YouTube SEO、内容简报、关键词与内容研究、内部搜索和智能体自动化流程,让视频内容更易于分析和使用。

该 API 适用于 Free 计划,并使用您的 SearchVector 积分,因此团队可以先测试转录提取,再将其构建到生产工作流程中。

适合智能体处理

返回结构化的转录片段,便于接入 LLM 智能体和自动化流程。

保留时间戳

保留片段的开始和结束时间,方便引用、剪辑、搜索和审核。

便于接入工作流程

将转录文本用于 SEO 内容简报、视频分析、内容更新和研究任务。

连接 SearchVector

将转录提取接入 SearchVector 的 SEO、YouTube、关键词和内容研究工具。

API 工作流程

从视频 URL 到 可用文本

为需要转录数据的应用提供简洁的请求方式,减少手动复制粘贴或本地浏览器自动化操作。

01

提交视频

发送 YouTube URL 或视频 ID,并指定工作流程需要的语言和输出格式。

02

接收转录 JSON

获取包含时间戳和分段边界的转录文本,供后续处理使用。

03

接入工作流程

总结视频、建立可搜索的资料库、制作 YouTube SEO 内容简报,或触发智能体后续任务。

构建转录工作流程,减少对网页抓取的依赖

当转录文本需要接入产品、智能体、报告或内容流程时,可使用 API 处理视频 URL。

视频 SEO 内容简报

在制作 YouTube 描述、视频大纲或博客内容简报之前,提取主题、问题、开场切入点和实体。

研究智能体

让智能体将长视频内容作为结构化文本处理,用于摘要、翻译规划、关键词研究和后续任务。

内容再利用

将网络研讨会、播客、产品视频和讲解视频整理成大纲、摘要、社交内容片段和 SEO 内容。

内部搜索

为带时间戳的转录片段建立索引,让团队能够搜索视频资料库,并跳转到讨论相关主题的位置。

功能概览

专为转录任务 自动化而设计

通过 API 提取转录文本,为产品、内容团队、SEO 工作流程和智能体提供数据。

输入 URL 或视频 ID

接受常见的 YouTube URL 格式,或应用中已标准化的视频 ID。

分段响应

将转录片段、时间戳和文本字段分开返回,便于后续处理。

JSON 响应结构

使用结构明确的响应对象,方便应用、笔记本、自动化流程和智能体处理。

支持批量任务流程

围绕队列、视频列表和重复转录任务设计流程,减少手动提取。

Built to connect

连接 SearchVector 工作流程

将转录分析结果用于 SearchVector 的关键词、YouTube SEO、内容简报和研究流程。

方便人工审核

保留时间戳,方便对照原始视频核查生成的摘要、翻译、内容简报和研究笔记。

支持 Free 计划

从 SearchVector Free 计划开始,在转录任务运行时使用您的 SearchVector 积分。

选择提取方式

比较转录提取方案 再开始构建

本地库、单次使用工具和连接工作流程的 API 解决不同的问题。请根据转录数据的实际用途选择合适方案。

01

本地库

适合脚本和实验,团队可以自行管理依赖、运行时行为和平台变化。

02

免费单次使用工具

适合粘贴一个视频 URL 并复制转录文本,但接入产品或智能体工作流程时可能不够方便。

03

SearchVector API 与工作流程

适合将转录数据接入平台内的 SEO 研究、YouTube 内容简报、内部搜索、内容规划和自动化流程。

FAQ

YouTube Transcript API 常见问题

关于在 SEO 和产品工作流程中使用转录数据的常见问题

使用转录数据构建 SEO 工作流程

使用 SearchVector 将 YouTube 转录与 SEO 研究、YouTube 内容简报、内部搜索、内容规划和自动化工作流程连接起来。

适用于 Free 计划,并使用您的 SearchVector 积分。