抖音七日点赞飙升榜

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

抖音七日点赞飙升榜

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

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

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/dy/search/getWeeklyRank

请求头

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

请求参数

参数类型必填说明示例
typeString否分类展示名称：小剧场 财富理财 二次元 身体锻炼 居家装修 数码科技 科学普及 旅行 美食 动物 明星娱乐 汽车 亲子 人文 三农 潮流风尚 游戏 生活记录 体育 舞蹈才艺 学习教育 休闲玩乐 影视 音乐 颜值造型 健康医学 综艺 个人成长 为空或"全部"时查询全部分类全部
startTimeString否榜单日期，格式：yyyy-MM-dd（可选，不传则默认前日 每日16:30更新昨日数据）2026-08-17

返回值与结构

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

响应字段

字段类型说明示例
add_collect_countInteger增量收藏数272493
add_comment_countInteger增量评论数68151
add_digg_countInteger增量点赞数3829510
add_forward_countInteger增量转发数0
add_share_countInteger增量分享数705598
ana_timeLong分析时间（毫秒时间戳）1787029306589
author_user_idString作者ID889919874537255
aweme_descString作品正文那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫
aweme_idString作品ID7672728393649065257
categoryString分类二次元
co_creatorsString联合创作者
cover_urlString作品封面链接https://p3-pc-sign.douyinpic.com/image-cut-tos/bcdf923b43a865b11951b4355fe499bc~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2102374800&x-signature=Xdt71Md053lg0zIPTtHUYg7ZhMk%3D&from=327834062&s=PackSourceEnum_WEBPC_RELATED_AWEME&se=false&sc=cover&biz_tag=pcweb_cover&l=202608180953570AC7E2BF2031E45DFD01
create_timeLong作品发布时间（毫秒时间戳）1786446297000
create_time_strStringcreate_time格式化后的字符串，格式：yyyy-MM-dd HH:mm:ss2026-08-11 19:04:57
is_creatorsString是否为创作者
rank_dateLong榜单日期（毫秒时间戳）1786896000000
rank_date_strStringrank_date格式化后的字符串，格式：yyyy-MM-dd HH:mm:ss2026-08-17 00:00:00
share_urlString作品分享链接https://www.iesdouyin.com/share/video/7672728393649065257
use_collect_countInteger截止当期的累计收藏数285356
use_comment_countInteger截止当期的累计评论数74628
use_digg_countInteger截止当期的累计点赞数4053341
use_forward_countInteger截止当期的累计转发数0
use_share_countInteger截止当期的累计分享数760139
user_avatarString作者头像https://p3.douyinpic.com/aweme-avatar/tos-cn-i-c9aec8xkvj_863a326c32844fdc88a95da68c923ead~tplv-dy-shrink:188:188.jpeg?from=2956013662
user_nicknameString作者昵称追番小天才

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": [
    {
      "add_collect_count": 272493,
      "add_comment_count": 68151,
      "add_digg_count": 3829510,
      "add_forward_count": 0,
      "add_share_count": 705598,
      "ana_time": 1787029306589,
      "author_user_id": "889919874537255",
      "aweme_desc": "那年熊大选择了最爷们的打法！#熊出没 #熊大 #爷们 #动画 #我在抖音看动漫",
      "aweme_id": "7672728393649065257",
      "category": "二次元",
      "co_creators": null,
      "cover_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos/bcdf923b43a865b11951b4355fe499bc~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2102374800&x-signature=Xdt71Md053lg0zIPTtHUYg7ZhMk%3D&from=327834062&s=PackSourceEnum_WEBPC_RELATED_AWEME&se=false&sc=cover&biz_tag=pcweb_cover&l=202608180953570AC7E2BF2031E45DFD01",
      "create_time": 1786446297000,
      "create_time_str": "2026-08-11 19:04:57",
      "is_creators": null,
      "rank_date": 1786896000000,
      "rank_date_str": "2026-08-17 00:00:00",
      "share_url": "https://www.iesdouyin.com/share/video/7672728393649065257",
      "use_collect_count": 285356,
      "use_comment_count": 74628,
      "use_digg_count": 4053341,
      "use_forward_count": 0,
      "use_share_count": 760139,
      "user_avatar": "https://p3.douyinpic.com/aweme-avatar/tos-cn-i-c9aec8xkvj_863a326c32844fdc88a95da68c923ead~tplv-dy-shrink:188:188.jpeg?from=2956013662",
      "user_nickname": "追番小天才"
    }
  ],
  "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操作过于频繁，请稍后再试触发频率限制，降低请求频率或增加调用间隔后重试。