获取 TikTok 视频评论
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填路径参数 video_id 获取 TikTok 视频评论，参数应为视频 ID 字符串，而非完整视频链接。可选查询参数 max_cursor 为分页字符串，首次请求请省略。已观察到的成功响应包含 status=ok，以及带有 status_code、comments、cursor、has_more 和 total 字段的 data 对象。一次有数据的测试返回了 50 条评论，cursor=50、has_more=1、total=6574；这些只是样本结果，并非固定的每页条数或保证的评论总量。已观察到的评论字段包括 aweme_id（所属视频 ID）、cid（评论 ID）、text、create_time（数值形式的创建时间）、digg_count（点赞数）、reply_comment_total（回复数）、reply_id、reply_to_reply_id 和 user。user 中的身份字段包括 uid、unique_id、nickname 和 sec_uid。一次负向对照测试返回 HTTP 200，且 data.status_code=0、comments=null、cursor=0、has_more=0、total=0。应将其作为空样本处理，不能据此断定视频不存在或没有公开讨论。has_more 非零表示可继续获取，但如何将响应中的 cursor 用作请求参数 max_cursor 尚未验证。此接口未记载可指定每页条数的参数，也未提供单独获取回复的操作；出现回复数量不代表已包含回复正文。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/tiktok/video-comments API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/video-comments?key=<API_KEY>&video_id=7468030505628224790'
查询结果
使用场景
- 利用评论文本、作者标识和创建时间，为指定视频中的提问与投诉建立人工审核队列。
- 将有限范围的评论样本导出为 CSV，保留所属视频 ID，并在合并已保存页面前按 cid 去重。
- 使用有数据页面和 comments=null 两类结果测试评论采集器，避免将空结果误报为服务故障或视频被删除。
- 根据已观察到的点赞数与回复数，为需要人工跟进的评论排序，同时避免假定已获取完整回复对话。
- 使用 cursor 和 has_more 记录采集进度，先验证 max_cursor 的续页对应关系，再实现自动多页采集原型。
常见问题
video_id 应填写 TikTok 视频链接吗？
不应填写完整链接。请在路径参数 video_id 中传入字符串形式的视频 ID，文档示例为 7468030505628224790。
已观察到哪些评论与作者字段？
评论记录中已观察到 aweme_id、cid、text、create_time、digg_count、reply_comment_total、reply_id、reply_to_reply_id 和 user。user 对象包含 uid、unique_id、nickname 和 sec_uid。不能仅凭这个样本假定还会返回其他字段。
max_cursor、cursor 和 has_more 有什么关系？
max_cursor 是请求中的可选字符串参数，cursor 和 has_more 则是在响应中观察到的字段。一次有数据的测试返回 cursor=50、has_more=1。首次请求请省略 max_cursor；自动分页前，需先验证如何将返回的 cursor 用于续页请求。文档未将其定义为页码。
comments=null 是否表示视频不存在？
不能可靠地这样判断。一次负向对照响应的 HTTP 状态为 200，同时 status_code=0、comments=null、cursor=0、has_more=0、total=0。可将 null 集合统一处理为空样本，但不能仅凭这种响应断言视频不存在或没有公开讨论。
能指定每页条数，或保证每次返回 50 条评论吗？
此接口未记载可控制每页条数的参数。一次有数据的测试包含 50 条评论并报告 total=6574，但这些数值均不保证适用于其他视频或请求。
reply_comment_total 是否意味着包含所有回复正文？
没有这项保证。它是已观察到的回复计数字段；响应中也出现了回复关联字段，但此接口未记载单独获取回复的操作，也不保证能导出完整对话。