TikTok Transcript API

TikTok Transcript API — auto-generated captions and multi-language subtitles, as clean, typed JSON, no TikTok login required.

原始信息汇总

数据集概述：TikTok Transcript API

API 名称：TikTok Transcript API 提供商：Stack-Pulse 类别：Social（社交） 当前版本：1.0.0

核心功能

从任何 TikTok 视频中提取自动生成的字幕和多语言翻译字幕，以结构化的 JSON 格式返回。无需 TikTok 登录、无需浏览器自动化、无需手动解析 WebVTT 文件。

主要输出内容

• 视频字幕：包含时间戳的文本片段（text, start_ms, duration_ms）。
• 语言选择：支持指定字幕语言代码（如 en, fra-FR）；默认返回视频原始口语语种的字幕。
• 可用语言列表：每次请求会返回该视频所有可用字幕语言，便于构建语言选择器。

输入标识符

提供以下至少一种标识符：

• 完整帖子 URL（参数 url）
• 裸帖子 ID（参数 post_id，长度 5–100 个字符），可搭配可选参数 username
• 可选参数 language：指定字幕语言

若未提供 url 或 post_id，将返回错误代码 400 REQUEST_VALIDATION_ERROR，附带 reason_code: "MISSING_REQUIRED_QUERY"。

端点

端点名称	路径	用途
Video transcript	/transcript	获取视频字幕（时间片段）及可用语言列表

错误处理

所有错误响应包含顶层字段 error_code，对于查询验证失败还会在 details 中提供更细粒度的 reason_code。

主要错误码

error_code	HTTP 状态码	含义
REQUEST_VALIDATION_ERROR	400	查询参数缺失或无效（附带 reason_code）
URL_BUILD	400	无法构建有效的 TikTok URL
HTTP_ERROR	502*	上游请求 TikTok 失败
PARSE_ERROR	422	无法解析 TikTok 的响应
NO_TRANSCRIPT	422	无可用字幕，或所请求的语言无匹配字幕
SUSPECT_RESPONSE	206	响应疑似机器人检测页面
NETWORK_ERROR	503	网络错误导致无法连接 TikTok

*HTTP_ERROR 携带 TikTok 实际状态码（如 404），未知时默认返回 502。

验证失败时的 reason_code（嵌套于 details 中）

reason_code	含义
MISSING_REQUIRED_QUERY	未提供 url 或 post_id
INVALID_URL_FORMAT	url 格式不可解析
INVALID_POST_ID	post_id 长度不在 5–100 字符范围内

订阅方案

方案	价格
BASIC	$0.00 / 月
PRO	$8.99 / 月
ULTRA	$49.99 / 月
MEGA	$119.99 / 月

选择该 API 的优势

• 无维护负担：API 自动追踪并适配 TikTok 内部数据结构和反爬签名变化。
• 一致的类型化响应：每次请求返回可预测的 JSON 格式（时间字幕片段），无需自行解析原始 WebVTT。
• 结构化可分支的错误码：所有失败响应包含 error_code 及可选的 reason_code，便于集成代码分支处理。
• 零部署要求：无需 TikTok 账号、无需维护 cookies 或会话令牌、无需 WebVTT 解析器。