TikTok Video Transcript
TikTok 视频字幕是公开视频中可用语音或字幕的文本记录，包含语言、纯文本或 WebVTT 格式、来源 URL、shortcode 和采集时间。这些记录可用于语音内容检索、关键词与主题分析、无障碍审核，以及保留来源的引文研究。
主要特性
- 多 URL 字幕查询在一个任务中处理一个或多个 TikTok 公开视频 URL，并可为每次查询传入语言偏好。
- 标准化文本与来源信息以一致结构返回字幕文本、语言、纯文本或 WebVTT 格式、来源 URL、记录 ID、shortcode 和采集时间。
- 仅保留可用字幕只有来源返回非空字幕文本时才生成结果，因此响应不会用占位记录代替不可用字幕。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 一个或多个可访问的 TikTok 公开视频 URL，使用逗号或换行分隔。 |
language | 可选 | 可选的字幕语言偏好，使用 en、es 或 fr 等两字母代码。 |
如何使用
把已知的 TikTok 公开视频 URL 作为异步任务提交，轮询 task ID，再将标准化字幕记录与请求来源逐一核对。
- 准备一个或多个可访问的 TikTok 公开视频 URL；需要指定语言时，使用 en 等两字母语言代码。
- 把 urls 和可选的 language POST 到 /v1/tiktok/video-transcript，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到状态为 succeeded 或 failed；任务成功时，结果数仍可能少于输入 URL 数。
- 读取 data.results.items，按 url 与输入列表核对；results.has_more 为 true 时继续传入 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传入 next_cursor最佳使用场景
- 可检索语音内容归档： 将字幕文本与来源 URL、语言、格式、shortcode 和采集时间一同索引，按口播词检索选定的公开视频。
- 关键词与主题分析： 分析已知视频集合中的标准化文本，查找重复出现的词语、短语与主题，同时保留来源链接便于复核。
- 无障碍与引文审核： 利用可用字幕文本和格式信息整理易读文本或查找相关段落，再回到关联的公开视频核对内容。
使用建议
- 提交前确认每个地址都能打开目标 TikTok 公开视频，因为请求只检查 URL 字符串非空，不会强制校验 TikTok 主机名或 /video/{id} 路径。
- 批量提交前统一 URL 并移除跟踪参数等变体，因为系统去除首尾空白后只会合并完全相同的字符串。
- 指定语言时使用 en 等两字母代码，并依据结果中的 language 安排后续处理，不要假定语言偏好一定得到满足。
- 任务成功后将返回的 url 与输入列表对比，保留没有结果的公开视频、私密视频、已删除视频、受限视频以及无可用字幕或语音的视频。
- 根据 format 选择解析方式，WebVTT 存在时保留提示结构；created_at 不含视频发布时间，数据追溯应使用 collected_at。
相关 API
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
- TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
- TikTok Search API — 按关键词搜索公开视频，并支持排序和发布时间筛选。
- TikTok Comment Replies API — 使用 TikTok 视频 URL 和 comment_id 采集一条已知评论下的公开回复，返回作者、互动、时间和父评论上下文。
- TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料，并保留来源上下文和支持的指标。
- TikTok Following List API — 采集 TikTok 账号公开可见的关注对象，返回标准化身份、简介、可见指标和来源账号信息。
- TikTok User Videos API — 按 username 采集公开个人资料视频，返回文案、创作者、媒体、时间、互动和来源账号上下文。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间，返回状态、主播信息、封面和受众计数。
- TikTok Trending Feed API — 按 region 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。