TikTok Comment Replies API

TikTok Comment Replies

主要特性

• 按已知评论限定回复范围将一个受支持的 TikTok 视频 URL 与其已知 comment_id 配对，采集该评论下的公开回复，而不是视频的顶层评论。
• 回复、作者与互动字段返回回复 ID 与文本、公开作者身份和账号标记、时间、可见点赞与回复计数、提及和来源视频上下文。
• 限定范围并自动去重在还有数据时继续传回复 cursor，按评论 ID 去重，并在达到请求上限、回复分支结束或采集满 100 页时停止。

参数

如何使用

先获得一条 TikTok 视频顶层评论的 ID，再提交异步回复任务，完成后通过结果 cursor 分页读取标准记录。

1. 对目标视频运行 TikTok Comments API，并选择需要查看回复的顶层评论 id。
2. 向 /v1/tiktok/comment-replies POST 同一视频的 url、该 comment_id，以及可选的 results_limit。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /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