获取 TikTok 评论与回复数据

TikTok 评论 API

提交视频地址,获取评论与可选回复。返回评论正文、用户名、时间、点赞数及父评论关系。

设置采集条件,获取任务 ID。

主评论与回复每 100 条 1 积分,不足百条按一档计费;查询免费。

GET示例响应
https://api.goanyapi.com/api/v1/tiktok-comments/tasks/{task_id}
可视化

正在加载保存示例…

运行后在这里查看响应

填入演示参数即可预览示例响应,不消耗积分;登录后可用自己的参数发起真实请求。

看懂评论与回复的字段关系

一个视频下的主评论与回复以结构化记录返回,可通过评论 ID 关联。下图展示字段关系,完整请求与响应见接口文档。

从视频地址到评论记录

用 video_url 传入完整视频地址,选择 mode=page,并按需开启 include_replies=true。提交后通过 task_id 查询记录;userName、createTime 与 likeCount 分别表示用户名、评论时间和点赞数,空字段保留实际返回值。

id
每条主评论和回复各自的唯一标识。图中 1001 是主评论,2001 与 2002 是回复。
parent_comment_id
回复指向所属主评论的 id;主评论的值为 null。结合 type 区分 comment 与 reply。
content
记录中的评论或回复正文。图中文字和 ID 仅用于说明字段关系。
TikTok 视频、主评论与两条回复的字段关系:回复的 parent_comment_id 指向主评论 id
TikTok 评论字段关系示意,非原站截图;图中 ID 与正文为说明用示例。

区分采集翻页与结果翻页

data.collection.next_cursor 用于新建下一页采集任务;data.results.next_cursor 作为 result_cursor 读取同一任务的下一页已保存记录。两种游标用途不同,不能互换。

选择评论采集范围

从一页主评论开始,按需包含回复。

按页或持续翻页

page 获取一页主评论,all 尝试可获取页面。

关联评论与回复

通过父评论 ID 还原讨论关系。

查看已保存记录

查看状态与数量,复制当前显示的 JSON。

常见问题

使用完整 HTTPS 视频地址与 GoAnyAPI API Key,不支持短链接。提交取得 task_id,再查询结果;受理不等于完成。

page 最多 40 条主评论,包含回复时总记录可超 40。all 尝试可获取页面,不与提交 cursor 同用,也不保证匹配 TikTok 显示总数。

不需要。提交时开启 include_replies,同一任务获取所选主评论的可获取回复。data.items 混合返回两类记录;type=reply 的 parent_comment_id 指向主评论,主评论该值为 null。

content 核对原话,userName 与 userAvatar 用于展示,createTime 标记评论时间,likeCount 比较互动,id 追溯记录。replyCount 是报告数,不是已采集数;已保存回复看 data.counts.replies,父子关联看 parent_comment_id。缺失或空字段按实际保留。

queued 或 running 时约每 5 秒查询,Tester 自动轮询。succeeded 表示所选范围完成。空 data.items 可能是尚未保存或当前页为空,需结合累计 data.counts.total;data.results.has_more=false 只表示当时无更多已保存结果。关闭页面不保证自动完成,后续查询可能仍需推进采集。

page 完成后,用 data.collection.next_cursor 新建下一页任务。data.results.next_cursor 则作为 result_cursor 翻看同一任务的已保存记录,两者不能互换。

未过期的 partial 或 failed 可查停止原因,按需补足积分并继续原任务,沿用记录、计数与费率;不同于新建下一页任务。

每次提交独立计费,去重已保存主评论与回复合计每 100 条向上取整,逐档扣费。当前费率见 Tester 与 Docs,任务沿用创建时费率;新任务独立取整,续跑不重复计费已有记录。

查询本身不另收费,但会推进采集,新增保存记录仍逐档计费。提前停止按已保存数量结算;零保存记录不扣采集费用。

至提交后 30 天,以 expires_at 为准;保存新记录或续跑不延长期限。

JSON 仅复制当前显示结果;完整读取按 Docs 的 result_cursor 分页,每次最多 100 条。CSV 需自行转换,保存示例也不是完整异步响应格式。

返回 JSON。查询响应的 data.items 包含评论与回复记录;type 区分记录类型,parent_comment_id 保留父子关系。完整任务结构、字段路径与分页示例见接口文档。