YouTube Transcript API

Extract clean transcripts from any YouTube video in seconds. Batch up to 50 videos per request, list all videos , choose caption language, and get timestamped segments plus plain text. Fast, cached, and reliable

原始信息汇总

数据集概述：YouTube Transcript API

提供者： haljishi 类别： 媒体

API 简介

该 API 允许用户通过单个 API 调用，从任何 YouTube 视频中提取干净、结构化的文本。返回的转录内容包括带时间戳的片段（适用于字幕、搜索和导航）和纯文本（适用于大语言模型、摘要和内容处理管道）。

核心端点与功能

1. POST /api/transcripts - 获取视频转录

• 功能： 在单个请求中获取一个或多个视频的转录。
• 请求参数：
  • ids (string[], 必需)：视频 ID 或完整 URL（支持 youtube.com/watch?v=...、youtu.be/...、Shorts 链接等），单次请求最多 50 个。
  • lang (string, 可选)：首选字幕语言代码（如 en、es、de），未指定时自动选择最佳可用轨道。
• 批量限制（按订阅计划）：
  • BASIC: 1 个视频/请求
  • PRO: 5 个视频/请求
  • ULTRA: 20 个视频/请求
  • MEGA: 50 个视频/请求
• 响应示例（单视频）： 返回每个视频的 id、title、author、language、languageCode、isGenerated、segments（包含 text、start、duration 的数组）以及 text（完整文本）。

2. POST /api/channels - 获取频道视频列表

• 功能： 列出某个频道上传的所有视频，便于直接输入到转录端点。
• 请求参数：
  • ids (string[], 必需)：频道句柄（如 @mkbhd）、频道 ID（如 UC...）或频道 URL。
• 响应： 返回 channelId、title、videoCount、videos 列表和 truncated 标志。每个频道最多返回其 500 个最近视频，如果 truncated: true 表示存在更多视频。

错误处理

错误信息明确且机器可读，并以 JSON 格式返回。

• 按项错误（在每个 results[] 项中返回，HTTP 200 状态下，单个视频失败不影响整个批次）：

  错误代码	含义
  invalid_id	不是有效的 YouTube 视频 ID 或 URL
  no_transcript	该视频没有字幕轨道
  transcripts_disabled	创作者已关闭该视频的字幕
  video_unavailable	视频为私密、已删除或区域限制
  age_restricted	视频有年龄限制，无法处理
  tier_limit	超出当前计划的单次调用批量限制，项目被跳过

• 请求级错误（HTTP 4xx 状态码）：

  错误代码	含义
  bad_request	请求体格式错误、空的 IDs 或单次调用中 IDs 超过 50 个

典型应用场景

• AI 摘要：将文本直接输入 Claude 或 GPT 进行摘要。
• RAG 视频库：索引带时间戳的片段，用于精准引用。
• 内容再利用：将视频转化为博客文章、节目笔记、通讯、社交媒体片段。
• 字幕工具：时间戳片段可直接用于字幕制作。
• 研究与监测：批量拉取频道视频并进行分析。

优势特点

• 速度快：缓存响应即时返回，首次冷提取通常在几秒内。
• 可靠性高：智能缓存、自动重试和请求强化确保高成功率。
• 多语言支持：支持 YouTube 上的所有语言，包括人工和自动生成字幕。
• 稳定的 JSON 格式：输出结构可预测，便于集成开发。