TikTok Transcript API

一次带鉴权的 GET 请求，提取公开 TikTok 视频已有的字幕轨道为 JSON——完整文本、语言和带时序的分段，直接接入应用。

单一 REST 端点
结构化 JSON 输出
带时序的字幕分段
语言偏好
先提取再转写
明确的不可用信号

请求示例

curl "https://api.agentbody.io/v1/tiktok/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

响应示例

来自 OpenAPI 规范的已文档化响应。

Existing captions or explicitly requested audio transcription.

{
  "caption_type": "manual",
  "language": "example_value",
  "segments": [],
  "text": "example_value",
  "video_id": "example_value"
}

功能特点

使用 TikTok Transcript API 从公开 TikTok 视频提取已有字幕轨道，返回结构化 JSON，服务调研管道、内容分析和视频感知产品。

单一 REST 端点

带上 Bearer API Key 和公开 TikTok 视频 URL，调用 GET /v1/tiktok/transcript。TikTok 字幕 API 通过一次文档化的 HTTP 请求返回视频已有字幕轨道，应用无需维护浏览器驱动爬虫或非官方客户端 SDK。

结构化 JSON 输出

在可预期的 JSON 响应中接收 caption_type、language、video_id、完整字幕文本和带时序的分段。适合存储字幕、索引文本、构建视频感知搜索或将字幕数据送入分析管道的服务。

带时序的字幕分段

每个分段包含字幕文本和时序信息。把搜索结果、引用或生成内容关联回原公开视频的确切时刻，而不是把 TikTok 视频字幕当作一整块无结构文本。

语言偏好

传入可选的 language 参数（BCP 47 标签，如 en 或 zh）请求首选字幕语言；不传则接受源语言。API 只读取视频已发布的轨道——不翻译、不合成不可用的语言。

先提取再转写

API 契约明确：在任何单独计费的语音转写之前，先尝试这个已有字幕操作。字幕提取是低成本、诚实的第一步；转写是另一个需要显式发起的操作，绝不静默兜底。

明确的不可用信号

公开视频没有字幕轨道时，API 返回 422 而不是编造文本。把它当作该 URL 的最终可用性信号——改选其他资源，或为转写流程取得明确批准，而不是原样重试。

使用步骤

按以下六步调用 TikTok Transcript API：传入公开视频 URL，处理带时序分段的字幕文本。

创建 API Key

创建 AgentBody 账号并在控制台生成 API Key。把 Key 保存在服务器环境或经批准的密钥存储中，以 Bearer Token 发送。绝不要把有效 Key 放进浏览器代码、公开仓库或客户端包。

选择公开视频

选定需要字幕的公开 TikTok 视频并复制完整 URL。视频必须有已发布的字幕轨道；私密、已删除和无字幕的视频返回不可用信号而非字幕。

构造 GET 请求

向 /v1/tiktok/transcript 发送带鉴权的 GET 请求，附上 URL 查询参数。本页生成的示例覆盖 curl、JavaScript、Python、Java 和 Go，可直接匹配你的服务已有的技术栈。

选择字幕语言

需要首选语言时，附加可选的 language 参数（BCP 47 值如 en 或 zh）。API 只返回所提交视频已发布的轨道——不生成翻译，也不提供不可用的语言轨道。

解析 JSON 响应

读取返回的 caption_type、language、video_id、完整文本和分段。需要可追溯引用、带时间戳的搜索结果或 RAG 上下文时保留分段时序。只存储产品所需字段，保留策略与隐私政策对齐。

正确处理 422

422 表示该视频没有可用的字幕轨道。不要原样重试同一 URL——这不是临时故障。改选其他公开资源，或在为该视频调用单独计费的转写操作前取得明确批准。

常见问题

TikTok Transcript API 是什么？

TikTok Transcript API 是带鉴权的 GET 端点 /v1/tiktok/transcript，从公开 TikTok 视频提取已有字幕轨道。传入公开视频 URL 和可选的首选语言；成功响应以 JSON 返回字幕元数据、完整文本和带时序的分段。

TikTok 字幕 API 会在没有字幕时生成字幕吗？

不会。该端点只提取视频已发布的字幕轨道，没有字幕轨道时返回 422 作为最终信号。语音转写——真正听音频并生成文本——是单独计费的操作，必须显式请求，绝不静默兜底。

它和 TikTok 字幕爬虫有什么区别？

字幕爬虫通常驱动浏览器会话并解析渲染后的字幕。这个 API 是文档化的 REST 端点，返回稳定的 JSON 字段，无需维护浏览器自动化、代理轮换或解析代码。它只读取公开字幕数据。

可以指定字幕语言吗？

可以。传入可选的 language 参数（BCP 47 标签如 en 或 zh）。API 返回所提交视频实际发布的轨道，不翻译字幕、也不创建源视频未提供的语言轨道。

422 响应代表什么？

422 表示该视频字幕不可用。这是最终信号而非临时错误——原样重试同一 URL 不会产生字幕。请改选其他公开视频，或在使用单独计费的转写操作前取得明确批准。

其他 API 错误怎么处理？

400 修正请求结构，401 配置有效 Bearer Key。临时性的 502、503、504 带退避重试。重试前记录状态码和错误代码，让管道能区分可用性问题（422）与暂时性上游故障。