快速开始

1. 体验公开免密接口

公开免密接口无需配置密钥，数据延迟 30 分钟、最多返回 20 条，便于快速评估数据格式：

curl "https://api.example.com/v1/public/feeds/{feed_key}/latest"

2. 获取 API Key

注册账号后在「开发者控制台」创建密钥（需要先验证邮箱）。密钥只会在创建时完整显示一次，请保存在服务端，不要写进浏览器或移动端客户端。

3. 携带密钥调用正式接口

curl "https://api.example.com/v1/feeds" -H "X-API-Key: $HOT_API_KEY"
curl "https://api.example.com/v1/feeds/{feed_key}/latest" -H "X-API-Key: $HOT_API_KEY"

先用「榜单列表」找到需要的榜单 key，再用「获取最新榜单」取数据。所有响应都是 { data, meta } 结构，见「响应结构」。

下一步

• 想看任意时刻的榜单：「历史时刻榜单」/v1/feeds/{key}/history?at=
• 想知道全网刚刚出现了什么：「全网首次上榜流」/v1/contents/latest
• 想判断数据是否足够新：「数据新鲜度」