API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

全网聚合热点TOP10列表

小时级更新最低 ¥0.03/次起即将上线需配置 API Key

全网聚合热点TOP10列表

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

POSThttps://redfox.hk/story/api/hotKeyword/list

API 密钥获取与配置

获取密钥

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

获取步骤

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

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/hotKeyword/list

请求头

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

请求参数

参数	类型	必填	说明	示例
startDate	String	是	开始时间，格式：yyyy-MM-dd HH:mm:ss	2026-08-19 00:00:00
endDate	String	是	结束时间，格式：yyyy-MM-dd HH:mm:ss	2026-08-20 00:00:00

返回值与结构

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

响应字段

字段	类型	说明	示例
hotSpotList	Array	热点列表
[0]	Object
firstRankTime	String	首次上榜时间	2026-08-19 15:00:00
hotId	String	热点ID	0780C0B9BE41E610537496317BC1B008
latestRankDate	String	最新上榜日期	2026-08-19 16:00:00
maxHotScore	Integer	最高热度值	9630519
maxPosition	Integer	最高排名	34
plat	Integer	平台代码	19
platName	String	平台名称	快手
title	String	标题	四川升学宴受伤17人生命体征平稳
topOfTheDayTime	String	当日登顶次数	2
url	String	链接地址	https://www.kuaishou.com/search/video?searchKey=四川升学宴受伤17人生命体征平稳
keyword	String	关键词
plats	Array	平台列表	[ "微博", "抖音", "头条", "快手", "百度" ]

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": [
    {
      "hotSpotList": [
        {
          "firstRankTime": "2026-08-19 15:00:00",
          "hotId": "0780C0B9BE41E610537496317BC1B008",
          "latestRankDate": "2026-08-19 16:00:00",
          "maxHotScore": 9630519,
          "maxPosition": 34,
          "plat": 19,
          "platName": "快手",
          "title": "四川升学宴受伤17人生命体征平稳",
          "topOfTheDayTime": "2",
          "url": "https://www.kuaishou.com/search/video?searchKey=四川升学宴受伤17人生命体征平稳"
        },
        {
          "firstRankTime": "2026-08-19 12:00:00",
          "hotId": "2FCBAC078915224EDD96D00F0AF60E87",
          "latestRankDate": "2026-08-19 13:00:00",
          "maxHotScore": 409821,
          "maxPosition": 32,
          "plat": 3,
          "platName": "微博",
          "title": "四川升学宴垮塌事故现场画面",
          "topOfTheDayTime": "3",
          "url": "https://s.weibo.com/weibo?q=%23四川升学宴垮塌事故现场画面"
        },
        {
          "firstRankTime": "2026-08-19 13:00:00",
          "hotId": "BF2F7B208DF77116003EA44CF9D18AF2",
          "latestRankDate": "2026-08-19 13:00:00",
          "maxHotScore": 746193,
          "maxPosition": 16,
          "plat": 3,
          "platName": "微博",
          "title": "四川升学宴 错别字",
          "topOfTheDayTime": "2",
          "url": "https://s.weibo.com/weibo?q=%23四川升学宴 错别字"
        }
      ],
      "keyword": "四川升学宴",
      "plats": [
        "微博",
        "抖音",
        "头条",
        "快手",
        "百度"
      ]
    }
  ],
  "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/hotKeyword/list" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "startDate": "2026-08-19 00:00:00",
  "endDate": "2026-08-20 00:00:00"
}'

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

json

{
  "code": 2000,
  "data": [
    {
      "hotSpotList": [
        {
          "firstRankTime": "2026-08-19 15:00:00",
          "hotId": "0780C0B9BE41E610537496317BC1B008",
          "latestRankDate": "2026-08-19 16:00:00",
          "maxHotScore": 9630519,
          "maxPosition": 34,
          "plat": 19,
          "platName": "快手",
          "title": "四川升学宴受伤17人生命体征平稳",
          "topOfTheDayTime": "2",
          "url": "https://www.kuaishou.com/search/video?searchKey=四川升学宴受伤17人生命体征平稳"
        },
        {
          "firstRankTime": "2026-08-19 12:00:00",
          "hotId": "2FCBAC078915224EDD96D00F0AF60E87",
          "latestRankDate": "2026-08-19 13:00:00",
          "maxHotScore": 409821,
          "maxPosition": 32,
          "plat": 3,
          "platName": "微博",
          "title": "四川升学宴垮塌事故现场画面",
          "topOfTheDayTime": "3",
          "url": "https://s.weibo.com/weibo?q=%23四川升学宴垮塌事故现场画面"
        },
        {
          "firstRankTime": "2026-08-19 13:00:00",
          "hotId": "BF2F7B208DF77116003EA44CF9D18AF2",
          "latestRankDate": "2026-08-19 13:00:00",
          "maxHotScore": 746193,
          "maxPosition": 16,
          "plat": 3,
          "platName": "微博",
          "title": "四川升学宴 错别字",
          "topOfTheDayTime": "2",
          "url": "https://s.weibo.com/weibo?q=%23四川升学宴 错别字"
        }
      ],
      "keyword": "四川升学宴",
      "plats": [
        "微博",
        "抖音",
        "头条",
        "快手",
        "百度"
      ]
    }
  ],
  "msg": "成功"
}