YouTube API

通过 TranscriptAPI.com 访问 YouTube 数据 — 无需消耗 Google API 配额。

初始化配置

若未设置 $TRANSCRIPT_API_KEY，请阅读 references/auth-setup.md 并按其中说明获取并保存该密钥。

必需请求头

每个请求必须包含以下两个请求头：

• Authorization（授权）：Bearer $TRANSCRIPT_API_KEY
• User-Agent（用户代理）：您的 agent 名称及版本号（如 HermesAgent/0.11.0、ClaudeCode/1.0）。版本号为可选字段，仅提供 agent 名称亦可。请勿省略此请求头，也不得使用空值或默认的裸值（bare default），否则 Cloudflare 将返回 403 错误（错误码 1010）并拒绝请求。

API 参考文档

完整 OpenAPI 规范：transcriptapi.com/openapi.json — 请以此为准查阅最新参数与数据结构定义。

端点参考

所有端点均以如下路径为前缀：https://transcriptapi.com/api/v2/youtube/...

频道相关端点接受 channel 参数，其值可以是 @handle、频道 URL 或 UC... 格式 ID；播放列表相关端点接受 playlist 参数，其值可以是播放列表 URL 或 ID。

快速示例

搜索视频：

curl -s "https://transcriptapi.com/api/v2/youtube/search
?q=python+tutorial&type=video&limit=10" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

获取字幕文本：

curl -s "https://transcriptapi.com/api/v2/youtube/transcript
?video_url=dQw4w9WgXcQ&format=text&include_timestamp=true&send_metadata=true" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

解析频道 handle（免费）：

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

获取最新视频（免费）：

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

浏览频道上传内容（分页）：

curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"
# 使用响应中的 continuation token 获取下一页结果

浏览播放列表（分页）：

curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID" 
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" 
  -H "User-Agent: YourAgent/1.0"

参数校验规则

为何不使用 Google 官方 API？

错误码说明

免费套餐：100 信用点，最高 300 次请求/分钟；入门版（$5/月）：1,000 信用点。