接口说明

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

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

请求URL

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

请求头

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

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

请求参数

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

options 参数说明

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

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

响应值

返回值类型说明
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/tiktok-transcript \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.tiktok.com/@nasa/video/7697300954667994381"
}'

返回示例

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

{
  "code": 0,
  "message": "ok",
  "pointCost": 0.8,
  "data": {
    "type": "transcript",
    "videoId": "7697300954667994381",
    "url": "https://www.tiktok.com/@nasa/video/7697300954667994381",
    "language": {
      "code": "en",
      "name": "eng-US",
      "isAutoGenerated": true
    },
    "tracks": [
      {
        "code": "en",
        "name": "eng-US",
        "isAutoGenerated": true
      }
    ],
    "segments": [
      {
        "startMs": 340,
        "durationMs": 3080,
        "text": "From breaking records on Mars to lighting up the skies over Earth,"
      }
    ],
    "text": "From breaking records on Mars to lighting up the skies over Earth,\nNASA put on quite a show this week.\nHere's what's new. And you're NASA minute.\nThere's a n..."
  },
  "meta": {
    "requestId": "pg-audit-r1-tiktok-transcript-1793954340368531100",
    "durationMs": 2716
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 1,
    "pointCost": 0.8
  }
}

积点消耗说明

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

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

在线调试