postdata

YouTube 字幕与评论 API：语言、时间戳和费用

用 /v1/youtube/transcript 读取现有字幕及时间片段，用 /v1/youtube/comments 单独读取评论样本，这是两个不同的数据调用。接入 PostToData 使用它的 API Key 或 MCP 认证，不需要向此服务提供 Google API Key。

文档核对: 2026-11-13 · 作者 PostToData

提取现有字幕不等于语音识别

此接口读取来源已有的字幕轨道，不会把任何无字幕视频的音频自动转成文字。lang 用于选择语言，来源必须有该字幕；默认优先英文，否则使用来源字幕。

保留字幕片段的开始时间，便于核查总结。字幕只能作为语音或字幕文字的证据，不能证明视频画面中的内容；依赖视觉信息的任务不能只读字幕。

一次字幕加一页有限评论

先读取一次字幕。确实需要观众反馈时，再批准同一个视频的一次评论查询，设 limit=5。评论是单独的样本，不能把几条评论写成全体观众的情绪比例。

MCP 分别使用 get_transcript 和 get_comments，platform=youtube。保留视频链接、可用时间戳和采集时间；下方接口文档提供 cURL、Python、JavaScript 和 MCP 示例。

计算整个任务的费用和失败处理

下方两项当前价格相加，就是一次成功“字幕加评论”任务的数据费用。每增加一个视频或评论页，都要重新计算调用；模型推理费用不包含在数据 API 价格中。

没有可用字幕的视频不扣费。超时或报错时先停止并核对返回结果及用量，不要无限重试。用 dry_run=1 免费查看报价，再将批准的价格作为 max_price_usd 随正式请求提交。

当前价格与真实接口

操作每次成功调用1,000 次成功调用
YouTube · 视频字幕$0.003$3.00
YouTube · 评论$0.003$3.00

1,000 次是标价乘以调用次数，不是 1,000 条数据，也不是充值套餐。以下仅预览第一项操作的价格，不访问数据上游、不扣额度。正式获取数据时移除 dry_run=1 并使用 Authorization: Bearer API_KEY；保留 max_price_usd 防止价格超过批准值。

免费价格预览
curl --get "https://posttodata.com/v1/youtube/transcript" \
  --data-urlencode 'id=UF8uR6Z6KLc' \
  --data-urlencode 'max_price_usd=0.003' \
  --data-urlencode 'dry_run=1'

费用上限只限制当前一次调用，不是整个任务的共享预算。逐项批准调用数量，遇到 402、412 或 429 时停止，不能自动提价或更换账号重试。

prices.json充值和试用规则打开对应工作流MCP 连接方式

常见问题

这是 Google 官方 YouTube Data API 吗？

不是，这是独立的第三方只读服务。如果任务需要官方账号权限、上传或管理功能，应评估官方 API 并单独确认其访问条件。

指定语言就能翻译任何视频吗？

不能。lang 选择已有字幕轨道，不提供翻译或无字幕音频转写。缺失字幕或语言必须明确标出。

相关指南