API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

获取指定视频的评论回复数据

最低 ¥0.03/次起即将上线

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

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

API 密钥获取与配置

获取密钥

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

获取步骤

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

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/tiktok/ability/commentReply

请求头

名称	类型	必填	说明	示例
REDFOX_API_KEY	string	否		ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type	string	是	请求体数据类型	application/json

请求参数

参数	类型	必填	说明	示例
itemId	string	是	作品id	7326156045968067873
commentId	string	是	评论id	7327061675382260482
cursor	integer	是	游标，用于翻页，第一页为"0"，第二页为上一次响应中的cursor值	0
count	integer	是	数量	10

返回值与结构

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

响应字段

字段	类型	说明	示例
code	integer	响应状态码，2000表示成功	2000
msg	string	响应消息	成功
data	object
commentList	array	评论列表
commentId	string	评论唯一ID	7328211878312002350
content	string	评论正文内容	fr and then others grow up n they become even clingier
hasMoreReplies	boolean	是否还有更多回复	true
language	string	评论语言代码	en
likeCount	integer	评论点赞数	120
publishTime	integer	评论发布时间（Unix时间戳，秒级）	1706232303
replyId	string	所属根评论ID	7327061675382260482
replyToCommentId	string		7328165990683706114
replyToUserHandle	string	被回复用户handle，顶级评论时为null	0
replyToUserId	string	被回复用户ID，顶级评论时为null	6991296595359843333
replyToUserName	string	被回复用户昵称，顶级评论时为null
threadId	integer	评论楼中楼层/线程ID	4
userData	object	评论发布者用户信息
avatarImage	string	用户头像URL	https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/xxx.webp
fansCount	integer	用户粉丝数	0
followCount	integer	用户关注数	0
secUserId	string	加密用户ID	MS4wLjABAAAAaGjN7AsFXStw6FPMNWs-MgIRZFHGKg2LS4ykqxeEUQCweX7rrwy8z-Uw7NdpoJ2q
userArea	string	用户所属地区	MX
userHandle	string	用户handle	angelitascomet
userId	string	用户数字ID	6838404783126266886
userName	string	用户昵称	Angelita
userSignature	string	用户个性签名，无签名时为空字符串	19 Just another Billie girl
workId	string	评论所属视频作品ID	7326156045968067873
hasMore	integer	是否还有更多数据：1-有，0-无	1
nextCursor	integer	下一页游标（数值型），翻页时传入下次请求	10
total	integer	评论总数	115

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": {
    "commentList": [
      {
        "commentId": "7328211878312002350",
        "content": "fr and then others grow up n they become even clingier",
        "hasMoreReplies": true,
        "language": "en",
        "likeCount": 120,
        "publishTime": 1706232303,
        "replyId": "7327061675382260482",
        "replyToCommentId": "7328165990683706114",
        "replyToUserHandle": "0",
        "replyToUserId": "6991296595359843333",
        "replyToUserName": "",
        "threadId": 4,
        "userData": {
          "avatarImage": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/xxx.webp",
          "fansCount": 0,
          "followCount": 0,
          "secUserId": "MS4wLjABAAAAaGjN7AsFXStw6FPMNWs-MgIRZFHGKg2LS4ykqxeEUQCweX7rrwy8z-Uw7NdpoJ2q",
          "userArea": "MX",
          "userHandle": "angelitascomet",
          "userId": "6838404783126266886",
          "userName": "Angelita",
          "userSignature": "19\nJust another Billie girl"
        },
        "workId": "7326156045968067873"
      },
      {
        "commentId": "7328621862838338310",
        "content": "oh man, my cats WHINE if they don't get their nightly cuttles...",
        "hasMoreReplies": false,
        "language": "en",
        "likeCount": 14,
        "publishTime": 1706327771,
        "replyId": "7327061675382260482",
        "replyToCommentId": "0",
        "replyToUserHandle": null,
        "replyToUserId": null,
        "replyToUserName": null,
        "threadId": 9,
        "userData": {
          "avatarImage": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/xxx.webp",
          "fansCount": 0,
          "followCount": 0,
          "secUserId": "MS4wLjABAAAAAbcJS_sor5cNuuVpwLf4fFHTessohyrHp3m6_KdHYkQ2iknquG5drYvGx1urA6rq",
          "userArea": "CA",
          "userHandle": "eir_head",
          "userId": "6818016812182782982",
          "userName": "Eirhead",
          "userSignature": ""
        },
        "workId": "7326156045968067873"
      }
    ],
    "hasMore": 1,
    "nextCursor": 10,
    "total": 115
  },
  "msg": "成功"
}

常见状态码说明

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

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

调用步骤

在请求头配置REDFOX_API_KEY或X-API-KEY
按 API 说明示例构造请求参数或请求体。
发起请求。
解析 JSON 响应中的 code、message 与 data 字段。

Request（示例代码，仅供参考）

bash

curl -X POST "https://redfox.hk/story/api/tiktok/ability/commentReply" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "REDFOX_API_KEY: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "itemId": "7326156045968067873",
  "commentId": "7327061675382260482",
  "cursor": 0,
  "count": 10
}'

Response（示例代码，仅供参考）

json

{
  "code": 2000,
  "data": {
    "commentList": [
      {
        "commentId": "7328211878312002350",
        "content": "fr and then others grow up n they become even clingier",
        "hasMoreReplies": true,
        "language": "en",
        "likeCount": 120,
        "publishTime": 1706232303,
        "replyId": "7327061675382260482",
        "replyToCommentId": "7328165990683706114",
        "replyToUserHandle": "0",
        "replyToUserId": "6991296595359843333",
        "replyToUserName": "",
        "threadId": 4,
        "userData": {
          "avatarImage": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/xxx.webp",
          "fansCount": 0,
          "followCount": 0,
          "secUserId": "MS4wLjABAAAAaGjN7AsFXStw6FPMNWs-MgIRZFHGKg2LS4ykqxeEUQCweX7rrwy8z-Uw7NdpoJ2q",
          "userArea": "MX",
          "userHandle": "angelitascomet",
          "userId": "6838404783126266886",
          "userName": "Angelita",
          "userSignature": "19\nJust another Billie girl"
        },
        "workId": "7326156045968067873"
      },
      {
        "commentId": "7328621862838338310",
        "content": "oh man, my cats WHINE if they don't get their nightly cuttles...",
        "hasMoreReplies": false,
        "language": "en",
        "likeCount": 14,
        "publishTime": 1706327771,
        "replyId": "7327061675382260482",
        "replyToCommentId": "0",
        "replyToUserHandle": null,
        "replyToUserId": null,
        "replyToUserName": null,
        "threadId": 9,
        "userData": {
          "avatarImage": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/xxx.webp",
          "fansCount": 0,
          "followCount": 0,
          "secUserId": "MS4wLjABAAAAAbcJS_sor5cNuuVpwLf4fFHTessohyrHp3m6_KdHYkQ2iknquG5drYvGx1urA6rq",
          "userArea": "CA",
          "userHandle": "eir_head",
          "userId": "6818016812182782982",
          "userName": "Eirhead",
          "userSignature": ""
        },
        "workId": "7326156045968067873"
      }
    ],
    "hasMore": 1,
    "nextCursor": 10,
    "total": 115
  },
  "msg": "成功"
}