TikTok Live&Videos API

TikTok video API to get profile videos, single video details, transcripts, live stream status, comments, comment replies, song details, and song videos. Collect public TikTok content, conversation threads, music usage, and live activity for content analysis, moderation, trend tracking, and media enrichment workflows.

原始信息汇总

数据集概述：TikTok Live & Videos API

一、核心功能

该API提供对公开TikTok内容的结构化访问，涵盖以下主要功能：

• 用户主页视频：获取指定TikTok用户的视频列表，支持排序和翻页。
• 单视频详情：查询单个TikTok视频的元数据，可选包含字幕或媒体下载。
• 视频字幕：获取视频的口述内容字幕，支持AI回退。
• 直播状态：检查指定用户是否正在直播。
• 评论与回复：拉取视频的评论及指定评论的回复，支持翻页。
• 音乐查询：获取TikTok音乐片段详情，或列出使用该音乐的视频。

二、典型应用场景

• 构建公开TikTok视频的内容采集管道。
• 提取视频字幕用于搜索索引、摘要或审核工作流。
• 监控评论和回复线程进行情感分析或社区分析。
• 追踪创作者直播活动。
• 分析TikTok上的音乐使用趋势。

三、可用端点列表

端点	用途
GET /profile/videos	获取用户主页视频列表
GET /video	获取单个视频的详细信息
GET /video/transcript	获取视频字幕
GET /user/live	检查用户直播状态
GET /video/comments	获取视频评论
GET /video/comment/replies	获取指定评论的回复
GET /song	获取音乐片段详情
GET /song/videos	获取使用该音乐的视频列表

四、重要输入参数

• 用户标识：handle（用户句柄）用于主页视频和直播查询；可选user_id可加快主页视频响应。
• 视频标识：url（完整视频链接）用于视频详情、字幕、评论和回复相关查询。
• 评论区标识：comment_id+视频url用于获取特定评论的回复。
• 音乐标识：clipId用于音乐详情和音乐视频列表查询。
• 分页参数：max_cursor（用于主页视频）、cursor（用于评论、回复和音乐视频）。
• 其他参数：sort_by（排序）、region（代理区域）、trim（精简响应）、language（字幕语言）、get_transcript（视频查询时同时获取字幕）、use_ai_as_fallback（字幕AI回退）、download_media（下载媒体）。

五、重要注意事项

• 仅限公开TikTok内容。
• 信用消耗：download_media=true在找到媒体时消耗10信用，否则消耗1信用；use_ai_as_fallback=true消耗10信用，且仅适用于2分钟以下的视频。
• 分页机制：主页视频使用max_cursor，评论/回复/音乐视频使用cursor。
• 区域参数：region用于选择代理位置或内容可用性上下文，并非严格的地理过滤器。
• 精简响应：trim=true可对部分端点返回较轻量的响应。
• 认证：该API未声明认证方案（需检查实际使用时的鉴权要求）。

六、响应特点

• 主页视频：返回视频列表及用于继续翻页的max_cursor。
• 视频详情：返回视频元数据，可选包括字幕数据或下载媒体URL。
• 字幕：返回视频的口述内容文本。
• 评论与回复：返回分页的对话数据。
• 直播：返回公开的直播状态信息。
• 音乐：返回音乐片段详情或使用该音乐的视频列表。