获取单个视频评论数据

最低 ¥0.03/次起即将上线

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/tiktok/ability/commentList

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

  1. 前往控制台页面，进入 API 密钥管理模块。
  2. 若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
  3. 在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/tiktok/ability/commentList

请求头

名称类型必填说明示例
REDFOX_API_KEYstring是平台鉴权令牌，每次请求必填ak_xxxxxx
Content-Typestring是请求体数据类型application/json

请求参数

参数类型必填说明示例
aweme_idstring否作品ID，必填7326156045968067873
cursorinteger否翻页游标，必填，第一页传00

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段类型说明示例
commentListarray评论列表
commentIdstring评论ID
contentstring评论内容
hasMoreRepliesboolean回复线程是否还有更多数据
languagestring评论语言
likeCountinteger点赞数
likedByAuthorboolean是否被作者点赞
pinnedByAuthorboolean是否由作者置顶
publishTimeinteger评论发布时间戳（秒）
replyCountinteger回复数
replyIdstring被回复的评论ID
shareDataobject分享信息
shareDescriptionstring分享描述
shareLinkstring分享链接
shareTitlestring分享标题
userDataobject评论用户信息
avatarImagestring用户头像
enterpriseVerifystring企业认证信息
fansCountinteger粉丝数
followCountinteger关注数
secUserIdstring用户加密ID
userAreastring用户地区
userHandlestring用户唯一标识
userIdstring用户ID
userNamestring用户昵称
userSignaturestring用户签名
verifyInfostring认证信息
workIdstring作品ID
hasMoreinteger是否还有更多数据，1-是，0-否
nextCursorinteger下一页游标

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": {
    "commentList": [
      {
        "commentId": "7327061675382260482",
        "content": "I love the kitten phase then they grow up and act like they too cool to sleep with you 😫😫😫😤😤",
        "hasMoreReplies": false,
        "language": "en",
        "likeCount": 38660,
        "likedByAuthor": false,
        "pinnedByAuthor": false,
        "publishTime": 1705964551,
        "replyCount": 62,
        "replyId": "0",
        "shareData": {
          "shareDescription": "shenoi’s comment: I love the kitten phase then they grow up and act like they too cool to sleep with you 😫😫😫😤😤",
          "shareLink": "https://www.tiktok.com/@cat_and_cat23/video/7326156045968067873?_d=eg2305e67hhaal&_r=1&comment_author_id=7013609719941383169&preview_pb=0&share_comment_id=7327061675382260482&share_item_id=7326156045968067873&sharer_language=en&source=h5_m&u_code=0",
          "shareTitle": "#cat #catsoftiktok "
        },
        "userData": {
          "avatarImage": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/f2588e5241dd3620301334e4756de42d~tplv-tiktokx-cropcenter-q:100:100:q70.webp?dr=8835&refresh_token=2431e06f&x-expires=1790665200&x-signature=aCWzTjwBJbvs%2FSdhNygEZXsbh6c%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=ff37627b&idc=useast8&sc=avatar&s=COMMENT_LIST",
          "enterpriseVerify": "",
          "fansCount": 0,
          "followCount": 0,
          "secUserId": "MS4wLjABAAAAIaQsa8tv1zt9xDG36_-cWmqiif8yxuQLBL0RlgJLIBq7uYT4WndVTLyNNmmNxLVT",
          "userArea": "AU",
          "userHandle": "shenoism",
          "userId": "7013609719941383169",
          "userName": "shenoi",
          "userSignature": "ENTJ-A.",
          "verifyInfo": ""
        },
        "workId": "7326156045968067873"
      }
    ],
    "hasMore": 1,
    "nextCursor": 20
  },
  "msg": "成功"
}

常见状态码说明

调用接口时，响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码说明排查建议
400请求参数错误检查请求体、Query 参数是否与文档一致，必填项是否齐全。
401鉴权失败确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY，且密钥有效、未禁用。
403无权限访问当前密钥或账号无权调用该接口，请检查密钥状态与接口权限。
500系统内部错误服务端异常，请稍后重试；持续出现请联系技术支持。
503服务暂不可用服务维护或短暂过载，请间隔一段时间后重试。
1001缺少必要参数对照「请求参数」表，补全必填字段。
1002参数格式不正确检查字段类型与格式（如 URL、日期、枚举值）是否符合说明。
1003参数类型错误确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
3103密钥不存在密钥可能已删除或填写错误，请前往控制台核对并重新复制。
3105API Key 已禁用在控制台启用该密钥，或创建新密钥后替换请求头中的值。
3201积分不足账户余额不足以支付本次调用，请前往控制台充值后再试。
3202积分账户不存在账号积分账户异常，请登录控制台确认账户状态。
4004操作过于频繁，请稍后再试触发频率限制，降低请求频率或增加调用间隔后重试。