API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

抖音每日热门作品榜

T+1最低 ¥0.03/次起即将上线需配置 API Key

抖音每日热门作品榜

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

POSThttps://redfox.hk/story/api/dy/search/likesRank

API 密钥获取与配置

获取密钥

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

获取步骤

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

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/dy/search/likesRank

请求头

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

请求参数

参数	类型	必填	说明	示例
type	String	是	类别（不传则查询全部）：小剧场、财富理财、二次元、身体锻炼、居家装修、数码科技、科学普及、旅行、美食、动物、明星娱乐、汽车、亲子、人文、三农、潮流风尚、游戏、生活记录、体育、舞蹈才艺、学习教育、休闲玩乐、影视、音乐、颜值造型、健康医学、综艺、个人成长	二次元
startTime	String	是	开始时间，格式：yyyy-MM-dd（可选，不传则默认昨日）每日10点后更新昨日数据	2026-08-11
endTime	String	是	结束时间，格式：yyyy-MM-dd（可选，不传则默认昨日）每日10点后更新昨日数据	2026-08-12

返回值与结构

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

响应字段

字段	类型	说明	示例
data	Array
[0]	Object
accountId	String	账号id	889919874537255
accountName	String	账号昵称	追番小天才
avatarUrl	String	账号头像	https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_ocFiJADqUAtUATYAEve7B9uCDjTfIx7AAxdgED.jpeg?from=327834062
category	String	作品分类	二次元
chaInfoTitle	String	话题标签
collectCount	Integer	收藏数	178140
commentCount	Integer	评论数	53045
commentTopKeywords	Array	评论热词
content	String	作品正文	那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫
coverUrl	String	作品封面链接	https://p95-zjwztc-sign.douyinpic.com/tos-cn-i-dy/4a2f5eae44c14c6d9aecdaf19c53fc1f~tplv-dy-resize-walign-adapt-aq:540:q75.webp?lk3s=138a59ce&x-expires=1787871600&x-signature=rLLkfiNPf68lcM8gqwXpN9OUMe8%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=cover&biz_tag=aweme_video&l=20260814070036D19473FDCE3697F545F0
duration	Integer	作品时长（秒）	229786
followerCount	Integer	账号粉丝数	73
isPromotion	String	是否带货（0=否，1=是）
likeCount	Integer	点赞数	2806906
popularityScore	String	热度得分（0-3分）
publishTime	String	发布时间	2026-08-11 19:04:57
recencyScore	String	时效得分（0-2分）
relevanceScore	String	相关性得分（0-10分）
repostCount	Integer	转发数	0
shareCount	Integer	分享数	545449
title	String	作品标题	那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫
totalScore	String	综合得分
workId	String	作品id	7672728393649065257
workType	String	作品类型（视频/图文）	0
workUrl	String	作品链接	https://www.iesdouyin.com/share/video/7672728393649065257

请求示例

{
  "type": "二次元",
  "startTime": "2026-08-11",
  "endTime": "2026-08-12"
}

响应示例

{
  "code": 2000,
  "data": [
    {
      "accountId": "889919874537255",
      "accountName": "追番小天才",
      "avatarUrl": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_ocFiJADqUAtUATYAEve7B9uCDjTfIx7AAxdgED.jpeg?from=327834062",
      "category": "二次元",
      "chaInfoTitle": null,
      "collectCount": 178140,
      "commentCount": 53045,
      "commentTopKeywords": [],
      "content": "那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫",
      "coverUrl": "https://p95-zjwztc-sign.douyinpic.com/tos-cn-i-dy/4a2f5eae44c14c6d9aecdaf19c53fc1f~tplv-dy-resize-walign-adapt-aq:540:q75.webp?lk3s=138a59ce&x-expires=1787871600&x-signature=rLLkfiNPf68lcM8gqwXpN9OUMe8%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=cover&biz_tag=aweme_video&l=20260814070036D19473FDCE3697F545F0",
      "duration": 229786,
      "followerCount": 73,
      "isPromotion": null,
      "likeCount": 2806906,
      "popularityScore": null,
      "publishTime": "2026-08-11 19:04:57",
      "recencyScore": null,
      "relevanceScore": null,
      "repostCount": 0,
      "shareCount": 545449,
      "title": "那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫",
      "totalScore": null,
      "workId": "7672728393649065257",
      "workType": "0",
      "workUrl": "https://www.iesdouyin.com/share/video/7672728393649065257"
    }
  ],
  "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/dy/search/likesRank" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "二次元",
  "startTime": "2026-08-11",
  "endTime": "2026-08-12"
}'

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

json

{
  "code": 2000,
  "data": [
    {
      "accountId": "889919874537255",
      "accountName": "追番小天才",
      "avatarUrl": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_ocFiJADqUAtUATYAEve7B9uCDjTfIx7AAxdgED.jpeg?from=327834062",
      "category": "二次元",
      "chaInfoTitle": null,
      "collectCount": 178140,
      "commentCount": 53045,
      "commentTopKeywords": [],
      "content": "那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫",
      "coverUrl": "https://p95-zjwztc-sign.douyinpic.com/tos-cn-i-dy/4a2f5eae44c14c6d9aecdaf19c53fc1f~tplv-dy-resize-walign-adapt-aq:540:q75.webp?lk3s=138a59ce&x-expires=1787871600&x-signature=rLLkfiNPf68lcM8gqwXpN9OUMe8%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=cover&biz_tag=aweme_video&l=20260814070036D19473FDCE3697F545F0",
      "duration": 229786,
      "followerCount": 73,
      "isPromotion": null,
      "likeCount": 2806906,
      "popularityScore": null,
      "publishTime": "2026-08-11 19:04:57",
      "recencyScore": null,
      "relevanceScore": null,
      "repostCount": 0,
      "shareCount": 545449,
      "title": "那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫",
      "totalScore": null,
      "workId": "7672728393649065257",
      "workType": "0",
      "workUrl": "https://www.iesdouyin.com/share/video/7672728393649065257"
    }
  ],
  "msg": "成功"
}