用途:浏览 YouTube 播放列表并获取其中视频的字幕/转录文本,适合用户分享播放列表链接、询问列表内容或需要批量获取列表视频信息的场景。
主要能力:
- 列出播放列表视频:调用 GET /api/v2/youtube/playlist/videos,支持按 playlist_id 获取首页(每页 100 条),或用 continuation 参数翻页。playlist_id 需以 PL、UU、LL、FL 或 OL 开头,二者只能提供其一。
- 返回数据包含视频 ID、标题、频道、时长、播放量、缩略图、索引,以及列表标题、视频数、描述、所有者、播放量等信息。
- 翻页流程:首个请求返回 100 条 + continuation_token,后续请求用该 token 继续,直到 has_more 为 false 或 token 为 null。
- 提取播放列表 ID:从 URL 中 ?list= 参数取得,例如 https://www.youtube.com/playlist?list=PLxxx 中 ID 为 PLxxx。
- 获取转录:调用 GET /api/v2/youtube/transcript,可传 video_url、format=text、include_timestamp=true、send_metadata=true。
使用方式:需要 $TRANSCRIPT_API_KEY。未设置时可用脚本注册:先 node ./scripts/tapi-auth.js register --email USER_EMAIL --password SECURE_PASS --json,收到 OTP 后执行 verify,再执行 save-key 保存密钥;也可在 transcriptapi.com/signup 手动获取。请求需带 Authorization: Bearer $TRANSCRIPT_API_KEY 头。
计费与限制:每页 1 学分,免费层 100 学分、300 请求/分钟。常见错误:400(参数二者须有其一)、402(无学分)、404(列表未找到,需公开)、408(超时,可重试一次)、422(ID 格式无效)。
暂未提供的信息:除上述免费学分与速率限制外的具体定价、其他平台支持情况、脚本的更多参数说明等暂无资料。