TikTok
TikTok Comments API
获取 TikTok 评论数据,支持接口列出的分页、排序或筛选参数。
接口说明
TikTok Comments API 获取 TikTok 评论数据,支持接口列出的分页、排序或筛选参数。
使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。
请求URL
请求头
| 参数名 | 参数值 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | application/json | string | 数据格式 |
| Authorization | Bearer xxx | string | 认证凭证 |
采集最长约75秒,客户端超时建议设为90秒。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| target | Yes | string | 帖子链接; 也可直接传视频 id (纯数字) |
| options | No | object | 仅处理下列开放参数;未列出的字段忽略,内部参数不可覆盖。 |
options 参数说明
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| maxPages | No | integer | 本次请求翻几页,默认 1,最大 5,按实际返回条数计费,更多数据用返回的游标续取 默认值: 1 最小值: 1 最大值: 5 |
| cursor | No | string | 续取评论: 上次输出的 pagination.comments.cursor (offset); 回复模式: 上次输出的 pagination.cursor (offset); 缺省从头 |
| commentId | No | string | 回复模式: 主评论 id (评论输出的 nativeId) |
仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。
每次默认1页,最多5页;页数必须为正整数,超过5按5处理。
提供非空commentId进入独立回复模式,按返回的直接回复计费;Facebook同时计入返回的嵌套回复。按本页cursor说明续取。
响应值
| 返回值 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码,0 表示成功 |
| message | string | 响应信息,成功时为 ok |
| pointCost | number | 本次请求实际消耗的积点 |
| data | object | 返回数据,结构见下表 |
| meta | object | 请求标识及耗时(毫秒) |
| billing | object | 计费条数、单价及规则版本 |
返回参数 data 说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| type | string | comments = 评论模式; replies = 回复模式 (传了 options.commentId) 可用值: [“comments”, “replies”] |
| commentsCount | number | null | 评论模式: 评论总数 |
| comments | object[] | 评论模式: 评论, 与 tiktok-post 同形 |
| commentId | string | 回复模式: 父评论 id |
| replyCount | number | null | 回复模式: 父评论的回复总数 |
| replies | object[] | 回复模式: 回复, 与评论 replys[] 同形 |
| pagination | object | 评论模式: {comments: {cursor, hasMore}}; 回复模式: {cursor, hasMore} |
data.comments[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| timeText | object | null | 评论时间 (text 为 ISO) |
| content | string | null | 评论内容 |
| likes | number | 点赞数 |
| avatar | string | null | 评论者头像 |
| nickname | string | null | 评论者昵称, 没有时用用户名 |
| nativeId | string | 评论 id; 回复模式传 options.commentId 用它 |
| replyCount | number | 回复数 |
| profileUrl | string | null | 评论者主页 |
| parentId | string | null | 所属顶层评论 id; 顶层评论为 null |
| replyToReplyId | string | null | 被回复的那条回复 id (楼中楼); 直接回复评论为 null |
| username | string | null | 评论者用户名 (@ 后面那段) |
| userId | string | null | 评论者 id |
| secUid | string | null | 评论者 secUid |
| verified | boolean | 评论者是否认证 |
| language | string | null | 评论语言代码 (un = 未识别) |
| isAuthorDigged | boolean | 作者是否点赞了这条评论 |
| isPinned | boolean | 是否置顶 |
| images | string[] | 评论图片链接 |
| labels | any[] | 评论标签 (上游原样) |
| replys | object[] | 随评论附带的一级回复。 |
data.comments[].timeText 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| text | string | null | 上游原始时间文本 |
| value | number | null | 解析后的毫秒时间戳; 解析失败为 null |
data.comments[].replys[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| timeText | object | null | 评论时间 (text 为 ISO) |
| content | string | null | 评论内容 |
| likes | number | 点赞数 |
| avatar | string | null | 评论者头像 |
| nickname | string | null | 评论者昵称, 没有时用用户名 |
| nativeId | string | 评论 id; 回复模式传 options.commentId 用它 |
| replyCount | number | 回复数 |
| profileUrl | string | null | 评论者主页 |
| parentId | string | null | 所属顶层评论 id; 顶层评论为 null |
| replyToReplyId | string | null | 被回复的那条回复 id (楼中楼); 直接回复评论为 null |
| username | string | null | 评论者用户名 (@ 后面那段) |
| userId | string | null | 评论者 id |
| secUid | string | null | 评论者 secUid |
| verified | boolean | 评论者是否认证 |
| language | string | null | 评论语言代码 (un = 未识别) |
| isAuthorDigged | boolean | 作者是否点赞了这条评论 |
| isPinned | boolean | 是否置顶 |
| images | string[] | 评论图片链接 |
| labels | any[] | 评论标签 (上游原样) |
| replys | any[] | 不再向下展开, 恒为空 |
data.replies[] 字段说明
| 返回值 | 类型 | 说明 |
|---|---|---|
| timeText | object | null | 评论时间 (text 为 ISO) |
| content | string | null | 评论内容 |
| likes | number | 点赞数 |
| avatar | string | null | 评论者头像 |
| nickname | string | null | 评论者昵称, 没有时用用户名 |
| nativeId | string | 评论 id; 回复模式传 options.commentId 用它 |
| replyCount | number | 回复数 |
| profileUrl | string | null | 评论者主页 |
| parentId | string | null | 所属顶层评论 id; 顶层评论为 null |
| replyToReplyId | string | null | 被回复的那条回复 id (楼中楼); 直接回复评论为 null |
| username | string | null | 评论者用户名 (@ 后面那段) |
| userId | string | null | 评论者 id |
| secUid | string | null | 评论者 secUid |
| verified | boolean | 评论者是否认证 |
| language | string | null | 评论语言代码 (un = 未识别) |
| isAuthorDigged | boolean | 作者是否点赞了这条评论 |
| isPinned | boolean | 是否置顶 |
| images | string[] | 评论图片链接 |
| labels | any[] | 评论标签 (上游原样) |
| replys | any[] | 不再向下展开, 恒为空 |
请求示例
返回示例
下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。
积点消耗说明
每条一级评论消耗 0.8 积点,附带回复免费。支持独立回复模式的接口按返回的直接回复条数计费,每条0.8积点,回复附带的下一层免费。
空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

