TikTok Comments
TikTok Comments 是用户对视频发表的公开回应，包含文本、作者信息、可见点赞数、回复数、提及和创作者互动信号。这些对话可用于分析受众反馈、研究重复主题、审阅情绪和监测内容反响。
主要特性
- 多视频评论采集在一次请求中采集多个 TikTok 直接视频 URL 下的公开顶级评论。
- 可追溯的评论记录用评论 ID、视频 URL 与作者信息保留反馈来源。
- 评论文本与提及提取评论文本和提及，为主题、情绪与需求归类提供素材。
- 公开互动信号在每条评论记录中返回可见点赞数、回复数、置顶状态和创作者点赞状态。
- 单视频结果上限按视频分别设置 results_limit，灵活分配活动或竞品研究样本。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的 TikTok 直接视频 URL 列表，用于采集对应视频的公开顶级评论。 |
results_limit | 可选 | 每个视频 URL 请求的顶级评论上限，必须为正整数，默认值为 100。 |
如何使用
选择要研究的视频和每条视频的评论样本量，开始收集受众反馈。
- 选择需要研究的内容样本，并为每个视频规划 results_limit。
- 把 urls 和 results_limit POST 到 /v1/tiktok/comments，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 从 data.results.items 读取评论；如果 has_more 为 true，则继续传入 next_cursor。
curl -X POST "https://api.socq.ai/v1/tiktok/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"],"results_limit":100}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传入 next_cursor最佳使用场景
- 用户声音研究： 从评论文本中归纳反复出现的需求、疑问、赞美和内容建议。
- 讨论审阅队列： 结合评论文本、可见点赞数和回复数，为客服、研究或舆情审阅整理评论。
- 内容创意反馈： 比较不同视频下的观众反应，识别引发共鸣、争议或讨论的创意点。
- 创作者互动观察： 通过置顶、创作者点赞和回复数量，了解创作者如何影响评论区讨论。
使用建议
- 先按视频重要性分配 results_limit，再用视频数量估算整批评论规模。
- 用 likes_count 衡量认可度，用 replies_count 衡量讨论深度，两者适合分别分析。
- 把 is_pinned 和 creator_liked 作为创作者主动选择的互动信号。
- 按评论 id 去重，同时保留视频 URL 和 collected_at，确保每条反馈来源清晰。
- 评论文本进入看板、工单或报告前进行安全转义，并保留原文供复核。
- 先用互动信号安排审阅顺序，再对原始评论文本做主题或情绪归类。
相关 API
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Hashtags 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 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。
- TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。