HotList今日热榜API开放文档

Employee

Web开发

发布于：2023年12月18日

字数：2k字

时长：7分钟

  项目目前处于【非稳定版本】状态，随时迭代更新中，暂仅供测试使用；未来会逐步增加更多平台的榜单数据。该文档更新时间为：2023-12-18，非最新版，详情请从正文点击跳转官网查看文档进行接入

一、介绍

1. 项目介绍

  HotList是基于Python Spider + FastAPI 实现的今日热榜编程接口，项目灵感来自于 今日热榜 ，API接口涵盖：微博、今日头条、豆瓣、百度、虎嗅、IT之家、BiliBili等全网热点榜单。

  为了确保服务器安全以及控制使用成本，所有接口在请求时需要在请求头中增加许可证信息进行认证。

目前已提供平台：

百度、微博、知乎、豆瓣、BiliBili、人人都是产品经理、IT之家、抖音、虎扑、澎湃新闻、36Kr、少数派、开眼视频、百度贴吧、AcFun、CSDN、掘金、PMCAFF、博客园、指趣游戏盒、果盘游戏、TapTap、吾爱破解、GitHub、猫眼、3DMGame、懂车帝

2. 版权说明

  所有API接口提供的信息资料、图片及视频等均来源于公开网络，接口仅提供基于类似搜索引擎类的推荐服务，所有详细信息均跳转到原始网页地址访问，不做任何转码类操作，服务器仅存储标题和链接，正文内容不做任何抓取存储，如果侵犯您的权益 ，请与我们联系,我们会尽快处理。同时请注意原网站的观点不表示我们也认同，信息内容真实性请自己辨别。

3. 联系我们

• 博客：https://www.zlinblog.cn

• QQ群：1043787769

二、接入

1. Licence申请

• 猛戳我！！！

2. Auth Licence

• 请通过 请求头 HEADER 传递接口的访问许可证 X-Licence（请务必保存好自己的密钥）

3. API地址

• 接口地址：https://api.zlinblog.cn

后方拼接请求路径；示例：

https://api.zlinblog.cn/single/rank?platform=抖音&rank_name=地区榜&city_code=110000

4. 接口详情

4.1 全部榜单数据

（1）描述：获取HotList今日热榜现有的全部榜单数据（获取的是最新数据）

（2）地址：https://api.zlinblog.cn/all/rank

（3）请求方法：GET

（4）查询参数

4.2 单条榜单数据

（1）描述：根据平台名称及榜单名称查询具体某一个榜单的数据（获取的是最新数据）

（2）地址：https://api.zlinblog.cn/single/rank

（3）请求方法：GET

（4）查询参数

• 具体平台与榜单名称列表请前往 官网-接口文档 进行查阅

4.3 模糊搜索热点

（1）描述：根据关键词查询全部榜单数据中存在的相关联的数据（获取的是最新数据）

（2） 地址：/all/hot/data

（3）请求方式：GET

（4）查询参数

4.4 自定义榜单数据

（1）描述：用于自定义榜单数据(自定义淘宝带货榜单或其他用于商业盈利性质的榜单数据)，请勿上传非法数据！

（2）地址： 请通过 官网 · 带货管理 菜单界面进行操作

5. 返回成功示例

{
  "code": 200,
  "msg": "ok",
  "name": "百度热搜",
  "data": {
    "version": "v1b1",
    "count": 2,
    "date_time": 1698658626,
    "stable": true,
    "list": [
      {
        "title": "OpenAI创始人加入微软",
        "heat": 4966581,
        "link": "https://www.baidu.com/s?wd=%E",
        "update_time": 1698658626
      },
      {
        "title": "乌尔善取关封神所有演员",
        "heat": 4969282,
        "link": "https://www.baidu.com/s?wd=%E4",
        "update_time": 1698658626
      }
    ]
  }
}

6. 请求报错示例

{
  "code": 100001,
  "msg": "证书不存在",
  "data": [
    {
      "version": "v1b1",
      "stable": true,
      "list": "null"
    }
  ]
}

7. 错误码

三、赞赏

• 您的小额赞助对我们的工作有着巨大的帮助，让我们得以持续改进与提升服务品质。

更新于：2024年3月2日

次浏览

0