FeedMCP

数据接口 / YouTube

YouTube 视频字幕 API

YouTube 视频的字幕全文和带时间的分段,可选语言;用平台自带字幕,不限视频长度。

项目 值
地址 GET https://api.feedmcp.com/v1/youtube/videos/transcript/get
ID youtube.videos.transcript.get
价格 $0.002 / 次
返回 一个 字幕对象
认证 Authorization: Bearer $FEEDMCP_API_KEY

用 YouTube 的字幕(包括自动生成的),不限视频长度;language 选语言,视频没有这种语言的字幕时返回默认字幕。

参数

参数 类型 必填 说明
id string 二选一 视频 ID(链接 v= 后面的 11 位)
url string 二选一 视频或帖子链接
language string 否 要哪种语言的字幕,两位语言代码,例如 en、zh、ja;不传就用视频的默认字幕

所有接口还支持 view=full:在返回里附上平台的原始数据(raw),价格不变。

返回字段

data.item 是一个「字幕」对象,所有平台字段相同:

字段 类型 说明
id string 视频或帖子的 ID,和这个平台详情接口用的一样
platform string 平台
url string | null 视频或帖子链接
language string | null 字幕语言(平台给的时候才有)
text string 字幕全文
segments {start, end, text}[] 带时间的分段,单位秒(YouTube、TikTok、Instagram、Reddit 有,其他平台为空)
duration_seconds number | null 视频时长(秒)
source 'captions' | 'ai' | null captions 平台自带字幕、ai AI 转写、null 不确定

什么时候扣费

成功取到数据一次 $0.002。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

每次返回的 meta.billing 里写着这次扣了多少、还剩多少余额。

调用示例

cURL

curl "https://api.feedmcp.com/v1/youtube/videos/transcript/get?id=Hz033eUq6Qw" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/youtube/videos/transcript/get",
    params={"id": "Hz033eUq6Qw"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/youtube/videos/transcript/get?id=Hz033eUq6Qw", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

在装好 FeedMCP 的 AI 里,调用 call 工具:

{
  "endpoint": "youtube.videos.transcript.get",
  "params": {
    "id": "Hz033eUq6Qw"
  },
  "max_price": "0.002"
}

返回示例

示例数据是虚构的,格式和真实返回一致。

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "id": "Hz033eUq6Qw",
      "platform": "youtube",
      "url": "https://www.youtube.com/watch?v=Hz033eUq6Qw",
      "language": "English",
      "text": "Need some help? It is getting windy now.",
      "segments": [
        {
          "start": 97.4,
          "end": 101.58,
          "text": "Need some help?"
        },
        {
          "start": 101.6,
          "end": 104,
          "text": "It is getting windy now."
        }
      ],
      "duration_seconds": null,
      "source": "captions"
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "youtube.videos.transcript.get",
    "platform": "youtube",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

出错时的格式见 错误码:每个错误都写明扣没扣钱(charged)和能不能重试(retry)。

YouTube的其他接口

常见问题

YouTube 视频字幕接口多少钱?

成功取到数据一次 $0.002。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

需要平台账号吗?

不需要,只取公开数据。

ID 或链接怎么找?

视频 ID 是链接里 v= 后面的 11 位字符;频道用 UC 开头的频道 ID(视频和搜索结果里的 author.id),暂不支持 @用户名。

怎么在 AI 里用?

装好 MCP 后直接说你要什么,AI 会调用 youtube.videos.transcript.get。