TikTok Comment Replies
TikTok 评论回复是位于一条已知视频评论之下的公开回应，包含回复文本、作者身份、时间、可见点赞与回复计数，以及父评论关联。这些对话记录可用于重建回复分支、查看参与者、研究回应内容和监测回复变化。
主要特性
- 按已知评论限定回复范围将一个受支持的 TikTok 视频 URL 与其已知 comment_id 配对，采集该评论下的公开回复，而不是视频的顶层评论。
- 回复、作者与互动字段返回回复 ID 与文本、公开作者身份和账号标记、时间、可见点赞与回复计数、提及和来源视频上下文。
- 限定范围并自动去重在还有数据时继续传回复 cursor，按评论 ID 去重，并在达到请求上限、回复分支结束或采集满 100 页时停止。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填 TikTok 视频 URL；主机名须为 tiktok.com、www.tiktok.com 或 m.tiktok.com，路径须包含 /video/{数字 ID}。 |
comment_id | 必填 | 必填的非空公开评论 ID，须对应同一视频中选定的顶层评论。 |
results_limit | 可选 | 该评论请求的最大回复数；默认为 100，接受 20 到 2,000 的整数。 |
如何使用
先获得一条 TikTok 视频顶层评论的 ID，再提交异步回复任务，完成后通过结果 cursor 分页读取标准记录。
- 对目标视频运行 TikTok Comments API，并选择需要查看回复的顶层评论 id。
- 向 /v1/tiktok/comment-replies POST 同一视频的 url、该 comment_id，以及可选的 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 通过 /v1/tasks/{task_id}?limit=50 读取 data.results.items，并在 results.has_more 为 true 时继续传 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'
# 轮询 GET /v1/tasks/{task_id}，再读取 data.results.items，并继续传 results.next_cursor。最佳使用场景
- 重建已知评论的回复分支： 结合回复 ID、extra.parent_comment_id 和 extra.input_url，重建一条指定顶层评论下的公开回复分支。
- 查看回复层级的回应： 利用回复文本、时间、可见点赞和回复计数，查看并比较一个聚焦对话中的公开回应。
- 梳理对话参与者： 使用公开作者 ID、username、个人资料链接、头像和账号标记，梳理返回回复中出现的参与者。
使用建议
- 从 TikTok Comments 顶层评论结果的标准化 id 取得 comment_id，并复用该结果的视频 URL；视频 ID 不能代替评论 ID。
- 提交前校验 URL 的主机名和数字 /video/ 路径，避免短链接、个人资料链接或非视频链接无法通过输入检查。
- 按所需回复量设置 results_limit，同时预期公开分支可能提前结束，且来源采集最多继续 100 页。
- 合并多个任务时按回复 id 去重，并保留 extra.parent_comment_id 与 extra.input_url，避免把回复归入错误对话。
- 下游代码应把回复文本、作者字段、指标、提及和时间按可空值处理，并在展示用户生成文本前进行转义。
相关 API
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
- TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
- TikTok Search API — 按关键词搜索公开视频，并支持排序和发布时间筛选。
- 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 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。
- TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。