TikTok
TikTok Transcript API
获取 TikTok 视频的字幕文本、时间片段及语言信息。
接口说明
TikTok Transcript API 获取 TikTok 视频的字幕文本、时间片段及语言信息。
使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。
请求URL
请求头
| 参数名 | 参数值 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | application/json | string | 数据格式 |
| Authorization | Bearer xxx | string | 认证凭证 |
采集最长约75秒,客户端超时建议设为90秒。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| target | Yes | string | 视频链接; 也可直接传视频 id (纯数字) |
| options | No | object | 仅处理下列开放参数;未列出的字段忽略,内部参数不可覆盖。 |
options 参数说明
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| lang | No | string | 字幕语言代码, 如 en; 没有该语言时用默认轨 (人工字幕优先) |
仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。
响应值
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,0 表示成功 |
| message | string | 响应信息,成功时为 ok |
| pointCost | number | 本次请求实际消耗的积点 |
| data | object | 返回数据,结构见下表 |
| meta | object | 请求标识及耗时(毫秒) |
| billing | object | 计费条数、单价及规则版本 |
返回参数 data 说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | Type 可用值: [“transcript”] |
| videoId | string | 视频 id |
| url | string | 视频链接 |
| language | object | null | 本次返回的字幕轨; 视频没有字幕为 null |
| tracks | object[] | 视频全部字幕轨 |
| segments | object[] | 字幕分段; 没有字幕为空数组 |
| text | string | 全部分段拼接的纯文本 |
data.language 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | string | null | 语言代码, 如 en |
| name | string | null | 语言名称 (平台原文) |
| isAutoGenerated | boolean | 是否自动生成 (语音识别) |
| isTranslatable | boolean | 仅 youtube: 是否支持机器翻译 |
data.tracks[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | string | null | 语言代码, 如 en |
| name | string | null | 语言名称 (平台原文) |
| isAutoGenerated | boolean | 是否自动生成 (语音识别) |
| isTranslatable | boolean | 仅 youtube: 是否支持机器翻译 |
data.segments[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| startMs | number | 相对视频开头的毫秒数 |
| durationMs | number | 持续毫秒数 |
| text | string | 字幕文本 |
请求示例
返回示例
下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。
积点消耗说明
每份非空字幕轨消耗 0.8 积点,同一轨道内的片段不单独计费。
空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

