​
接口说明

YouTube Transcript API 获取 YouTube 视频的字幕文本、时间片段及语言信息。

使用 Pangolinfo API Key 调用，返回结构化 JSON 数据。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/youtube-transcript

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集最长约75秒，客户端超时建议设为90秒。

​
请求参数

参数必填类型说明
targetYesstring视频链接; 也可直接传视频 id (如 dQw4w9WgXcQ)
optionsNoobject仅处理下列开放参数；未列出的字段忽略，内部参数不可覆盖。

​
options 参数说明

参数必填类型说明
langNostring字幕语言代码, 如 en / zh-Hans; 人工字幕优先于自动字幕; 没有该语言时用默认轨 (人工优先)

仅处理本页列出的请求参数，其他字段忽略。分页游标原样传回，不编码、解码或转换格式。

​
响应值

返回值类型说明
codeinteger状态码，0 表示成功
messagestring响应信息，成功时为 ok
pointCostnumber本次请求实际消耗的积点
dataobject返回数据，结构见下表
metaobject请求标识及耗时（毫秒）
billingobject计费条数、单价及规则版本

​
返回参数 data 说明

返回值类型说明
typestringType
可用值: [“transcript”]
videoIdstring视频 id
urlstring视频链接
languageobject | null本次返回的字幕轨; 视频没有字幕为 null
tracksobject[]视频全部字幕轨
segmentsobject[]字幕分段; 没有字幕为空数组
textstring全部分段拼接的纯文本

​
data.language 字段说明

返回值类型说明
codestring | null语言代码, 如 en
namestring | null语言名称 (平台原文)
isAutoGeneratedboolean是否自动生成 (语音识别)
isTranslatableboolean仅 youtube: 是否支持机器翻译

​
data.tracks[] 字段说明

返回值类型说明
codestring | null语言代码, 如 en
namestring | null语言名称 (平台原文)
isAutoGeneratedboolean是否自动生成 (语音识别)
isTranslatableboolean仅 youtube: 是否支持机器翻译

​
data.segments[] 字段说明

返回值类型说明
startMsnumber相对视频开头的毫秒数
durationMsnumber持续毫秒数
textstring字幕文本

​
请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/youtube-transcript \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}'

​
返回示例

下例截取实际响应中的首条列表记录，长文本与链接作了缩写；pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。

{
  "code": 0,
  "message": "ok",
  "pointCost": 0.8,
  "data": {
    "type": "transcript",
    "videoId": "dQw4w9WgXcQ",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": {
      "code": "en",
      "name": "English",
      "isAutoGenerated": false,
      "isTranslatable": true
    },
    "tracks": [
      {
        "code": "en",
        "name": "English",
        "isAutoGenerated": false,
        "isTranslatable": true
      }
    ],
    "segments": [
      {
        "startMs": 1360,
        "durationMs": 1680,
        "text": "[♪♪♪]"
      }
    ],
    "text": "[♪♪♪]\n♪ We're no strangers to love ♪\n♪ You know the rules and so do I ♪\n♪ A full commitment's what I'm thinking of ♪\n♪ You wouldn't get this from any other g..."
  },
  "meta": {
    "requestId": "pg-audit-r1-youtube-transcript-1793954279655693700",
    "durationMs": 5817
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 1,
    "pointCost": 0.8
  }
}

​
积点消耗说明

每份非空字幕轨消耗 0.8 积点，同一轨道内的片段不单独计费。

空结果、失败响应不扣费。同一响应中相同 ID 只计一次，独立调用和续页分别计费。详见 社媒评论 API 计费说明。

在线调试