小喵热点 API

基于 DailyHotApi 的自部署服务。OpenAPI 文档 · 健康检查

鉴权

数据接口需要请求头 Authorization: Bearer YOUR_API_KEY，也支持 X-API-Key。请勿把密钥放进公开网页或 URL。

调用示例

curl https://hot.xiaomiao.store/api/v1/sources \
  -H "Authorization: Bearer $HOT_API_KEY"

curl "https://hot.xiaomiao.store/api/v1/hot/weibo?limit=10" \
  -H "Authorization: Bearer $HOT_API_KEY"

curl "https://hot.xiaomiao.store/api/v1/hot/baidu?limit=20&keyword=旅行" \
  -H "Authorization: Bearer $HOT_API_KEY"

接口

• GET /api/v1/sources：平台及最近调用状态。
• GET /api/v1/hot/{source}：平台默认榜单，支持 limit=1～100、keyword（标题与描述筛选）。
• GET /health：服务存活检查。

缓存与状态

按需刷新，缓存 30 分钟；实际数据更新时间看 updatedAt。上游故障时可返回 24 小时内旧数据，并设置 stale=true；没有可用缓存则返回 502。sources 中 unknown 表示尚未验证，ok 表示最近一次成功，unavailable 表示最近一次失败。当前未提供小红书站内热榜。

无每日调用配额；入口按 IP 限速 5 次/秒，允许短时突发 20 次，超限返回 429。热点数据依赖各平台，上游可能调整或限制访问。不同平台的 hot 值不宜直接比较。

响应示例（非实时数据）

{
  "code": 200,
  "source": "weibo",
  "title": "微博",
  "type": "热搜榜",
  "total": 1,
  "updatedAt": "2026-09-08T00:00:00.000Z",
  "fetchedAt": "2026-09-08T00:00:00.000Z",
  "cached": true,
  "stale": false,
  "data": [
    {
      "rank": 1,
      "id": "example",
      "title": "示例标题（非实时数据）",
      "url": "https://example.com",
      "hot": 12345,
      "desc": ""
    }
  ]
}