今日热榜 · API 接口

API 使用规则

在你开始使用 今日热榜 API 之前，请了解我们关于 API 使用方面的规则：

• 我们对于 API 的一切有意义的用途持开放态度，我们鼓励将 今日热榜 API 用于学术研究、手机应用及浏览器扩展。
• 我们反对将 API 输出的结果用于填充你的商业网站的内容，同时 API 严禁用于任何违法项目。
• 大部分 API 会带有每小时请求数量限制，请在获取信息后缓存使用。
• 带的接口需联系我们申请使用，申请授权。

API Rate Limit

默认情况下，每个 IP 每小时可以发起的 API 请求数被限制在 100 次。你可以在 API 返回结果的 HTTP 头部找到 Rate Limit 信息：

X-Rate-Limit-Limit: 100
X-Rate-Limit-Reset: 1577808001
X-Rate-Limit-Remaining: 99

请求数量限制在调用方缓存接口数据下完全足够使用，请勿在前端直接调用今日热榜的接口，请获取后在自己服务器缓存使用，谢谢。

实时榜中榜

今日热榜全部榜单每天用户点击最多的 100 条内容。

https://open.tophub.today/hot

• Method: GET
• Authorization: None

今日早报

全网精选 20 条国内外新闻简报、历史上的今天以及 +1 条毒鸡汤。

https://open.tophub.today/daily

• Method: GET
• Authorization: None

节点列表

获得今日热榜全站节点列表。

https://open.tophub.today/nodes

• Method: GET
• Authorization: YES（密钥联系我们获取）

接受以下参数之一：

• p: 当前页码
• pagesize: 每页获取纪录数（可选）

例如：

https://open.tophub.today/nodes?p=1&pagesize=20

节点最新信息（榜单或最新）

获得指定节点的最新榜单或最新更新的内容列表。

https://open.tophub.today/nodes/@hashid

• Method: GET
• Authorization: YES（密钥联系我们获取）

接受参数：

• hashid: 节点 hashid（和网站节点详细页地址栏 hashid 一致）

例如：

https://open.tophub.today/nodes/KqndgxeLl9

内容搜索

搜索全站或者指定节点内容。

https://open.tophub.today/search

• Method: GET
• Authorization: YES（密钥联系我们获取）

接受参数：

• q: 搜索关键词
• nodeid: 搜索限定节点 hashid（可选）
• p: 当前页码
• pagesize: 每页获取纪录数（可选）

例如：

https://open.tophub.today/search?q=keyword&p=1&pagesize=20

2020-01-01 · ieliwb · 今日热榜 · Theme by Github