Infoget Hotspots HTTP API

Infoget Hotspots 提供面向开发者和 AI Agent 的中文互联网热点热榜 API。公开接口只读取服务器缓存，不会在用户请求时直接抓取源站；后台调度器会按 config/hotspots_scheduler.json 自动刷新缓存。

示例中的 BASE_URL 需要替换成实际服务地址，例如 http://axiafeed.com。

健康检查

GET /api/health

返回服务状态。

热点快照

GET /api/hotspots?limit_per_platform=50

返回归一化后的热点快照，适合 Agent 快速读取跨平台热点上下文。limit_per_platform 只限制返回条数，不触发源站抓取。

榜单目录

GET /api/boards

返回当前缓存中有哪些榜单，不包含新闻条数，适合先让 Agent 了解可选数据源。

全部榜单

GET /api/boards/all?limit_per_board=50

返回所有榜单及榜单条目，默认每个榜单最多 50 条。

单个榜单

GET /api/boards/{board}?limit=50

board 可以使用榜单名称或 /api/boards 返回的 id。

兼容刷新接口

POST /api/hotspots/refresh

该接口用于兼容旧客户端。当前公开请求不会立即抓取源站，只返回最新缓存，并在 errors[] 中说明数据由后台定时更新。

curl -X POST "BASE_URL/api/hotspots/refresh" \
  -H "Content-Type: application/json" \
  -d '{"limit_per_platform":50}'

条目字段

失败模型