HotList今日热榜/全网热点榜单/热搜榜单/新闻热榜API接口

user8542013256849
1,439 阅读8分钟

一、介绍

1. 项目介绍

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

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

目前已提供平台：

百度、微博、知乎、豆瓣、BiliBili、人人都是产品经理、IT之家、抖音、虎扑、澎湃新闻、36Kr、少数派、开眼视频

2. 版权说明

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

3. 联系我们

二、接入

1. Licence申请

2. API地址

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

后方拼接请求路径；示例：https://api.zlinblog.cn/hot/v1b1/douban/book/top250

3. Auth Licence

  • 请求头Header
名称值
X-Licence3yVabcd1234d597
api_example

4. API接口

平台接口名称请求路径请求方式数据更新周期状态
百度热搜/hot/v1b1/baiduGET10分钟√
小说榜/hot/v1b1/baidu/novelGET6小时√
电影榜/hot/v1b1/baidu/movieGET6小时√
电视剧榜/hot/v1b1/baidu/teleplayGET6小时√
汽车榜/hot/v1b1/baidu/carGET6小时√
游戏榜/hot/v1b1/baidu/gameGET6小时√
微博热搜/hot/v1b1/weiboGET5分钟√
文娱榜/hot/v1b1/weibo/entertainmentGET10分钟√
要闻榜/hot/v1b1/weibo/newsGET10分钟√
话题榜/hot/v1b1/weibo/topicGET10分钟√
知乎热榜/hot/v1b1/zhihuGET15分钟√
豆瓣最受关注图书榜/hot/v1b1/douban/book/attentionGET24小时√
畅销图书榜/hot/v1b1/douban/book/saleGET24小时√
图书TOP250/hot/v1b1/douban/book/top250GET24小时√
新片榜/hot/v1b1/douban/movie/newGET24小时√
电影TOP250/hot/v1b1/douban/movie/top250GET24小时√
一周口碑榜/hot/v1b1/douban/movie/prestigeGET24小时√
北美票房榜/hot/v1b1/douban/movie/usaGET24小时√
音乐250TOP/hot/v1b1/douban/music/top250GET24小时√
BiliBili综合热门/hot/v1b1/bilibili/popularGET10分钟√
全站排行/hot/v1b1/bilibiliGET10分钟√
番剧排行/hot/v1b1/bilibili/bangumiGET1小时√
国产动画排行/hot/v1b1/bilibili/guochanGET1小时√
国创相关排行/hot/v1b1/bilibili/guochuangGET1小时√
纪录片排行/hot/v1b1/bilibili/documentaryGET1小时√
动画排行/hot/v1b1/bilibili/dougaGET1小时√
音乐排行/hot/v1b1/bilibili/musicGET1小时√
舞蹈排行/hot/v1b1/bilibili/danceGET1小时√
游戏排行/hot/v1b1/bilibili/gameGET1小时√
知识排行/hot/v1b1/bilibili/knowledgeGET1小时√
科技排行/hot/v1b1/bilibili/techGET1小时√
运动排行/hot/v1b1/bilibili/sportsGET1小时√
汽车排行/hot/v1b1/bilibili/carGET1小时√
生活排行/hot/v1b1/bilibili/lifeGET1小时√
美食排行/hot/v1b1/bilibili/foodGET1小时√
动物圈排行/hot/v1b1/bilibili/animalGET1小时√
鬼畜排行/hot/v1b1/bilibili/kichikuGET1小时√
时尚排行/hot/v1b1/bilibili/fashionGET1小时√
娱乐排行/hot/v1b1/bilibili/entGET1小时√
影视排行/hot/v1b1/bilibili/cinephileGET1小时√
电影排行/hot/v1b1/bilibili/movieGET1小时√
电视剧排行/hot/v1b1/bilibili/tvGET1小时√
综艺排行/hot/v1b1/bilibili/varietyGET1小时√
原创排行/hot/v1b1/bilibili/originGET1小时√
新人排行/hot/v1b1/bilibili/rookieGET1小时√
人人都是产品经理日榜/hot/v1b1/woshipm/dailyGET12小时√
周榜/hot/v1b1/woshipm/weeklyGET5天√
月榜/hot/v1b1/woshipm/monthlyGET20天√
IT之家阅读榜/hot/v1b1/ithome/readGET6小时√
最热榜/hot/v1b1/ithome/hotGET6小时√
打分榜/hot/v1b1/ithome/scoresGET6小时√
抖音热点榜/hot/v1b1/douyin/hotGET5分钟√
种草榜/hot/v1b1/douyin/grassGET5分钟√
娱乐榜/hot/v1b1/douyin/entertainmentGET5分钟√
社会榜/hot/v1b1/douyin/societyGET5分钟√
挑战榜/hot/v1b1/douyin/challengeGET5分钟√
地区榜/hot/v1b1/douyin/area?city_code=xxxxxxGET5分钟doing
虎扑步行街热帖/hot/v1b1/hupuGET10分钟√
澎湃新闻热榜/hot/v1b1/pengpaiGET20分钟√
36Kr综合榜/hot/v1b1/36krGET5分钟√
人气榜/hot/v1b1/36kr/popularGET5分钟√
收藏榜/hot/v1b1/36kr/collectGET5分钟√
少数派热榜/hot/v1b1/sspaiGET2小时√
开眼视频日报/hot/v1b2/eyeGET6小时√

5. 返回成功示例

{
  "code": 200,
  "msg": "ok",
  "name": "百度热搜",
  "data":{
      "version": "v1b1",
      "count": 2,
      "date_time": 1698658626,
      "stable": true,
      "list": [
        {
          "title": "  中国将始终是世界发展的重要机遇 "
          "heat": 4966581,
          "link": "https://www.baidu.com/s?wd=%E4%B8%AD%E5%9B%BD%E5%B0%86%E5%A7%8B%E7%BB%88%E6%98%AF%E4%B8%96%E7%95%8C%E5%8F%91%E5%B1%95%E7%9A%84%E9%87%8D%E8%A6%81%E6%9C%BA%E9%81%87&sa=fyb_news&rsv_dl=fyb_news",
          "update_time": 1698658626
        },
        {
          "title": "  中央军委副主席张又侠谈台湾问题 ",
          "heat": 4969282,
          "link": "https://www.baidu.com/s?wd=%E4%B8%AD%E5%A4%AE%E5%86%9B%E5%A7%94%E5%89%AF%E4%B8%BB%E5%B8%AD%E5%BC%A0%E5%8F%88%E4%BE%A0%E8%B0%88%E5%8F%B0%E6%B9%BE%E9%97%AE%E9%A2%98&sa=fyb_news&rsv_dl=fyb_news",
          "update_time": 1698658626
        }
      ]
    }
}
名称类型说明
codeint返回状态码，成功返回为200
msgstr返回说明，成功返回为OK
namestr数据源名称
datalist[dict]数据结果集
versionstr当前接口版本号
countint结果数量
date_timedatetime数据更新时间（时间戳）
stablebool接口是否为稳定版本
listlist[dict]返回结果集
titlestr标题
heatint热度，部分接口没有该字段
linkstr源地址
update_timedatetime数据爬取时间（时间戳）

6. 请求报错示例

{
  "code": 100001,
  "msg": "证书不存在",
  "data": [
    {
      "version": "v1b1",
      "stable": true,
      "list": "null"
    }
  ]
}
名称类型说明
codeint返回状态码，详见下方正文错误码
msgstr返回说明，详见下方正文错误码
datalist[dict]数据结果集
versionstr当前接口版本号
stablebool接口是否为稳定版本
liststr返回结果集，接口报错时该字段始终为null

7. 错误码

错误码描述
100001证书不存在
100002证书为未申请状态，请先申请证书
100003证书已过期，请重新申请证书
100004总请求次数不足，请续费或重新申请证书
100005当日剩余请求次数不足，请明日再试
100101接口列表获取失败
100102请在请求头中定义X-Licence证书进行认证(X-Licence=xxxxx)
200001证书列表为空
200002未找到该证书
200003删除证书失败
200004申请证书失败
200100您已申请过许可证，不可重复申请
200200重置免费版每日剩余请求次数：暂无数据可重置
200201添加证书失败
200202传入证书类型错误
200203证书库存不足，请联系管理员进行补充
200204传入证书数量错误
200205目前仅支持申请包月版证书(可免费申请)
200206当日剩余数量不足
200207总剩余数量不足
300001爬虫数据异常，请联系管理员
300002主体网页爬取失败，请检查异常
300003部分HTML字段信息爬取失败，请检查异常
300004HTML网页解析失败，请检查异常
300005JSON网址解析失败，请检查异常
300006网址解析方式出错，请更换网页解析方式
300007部分JSON字段信息爬取失败，请检查异常
300008请传入地级市区域代码，如110000、440100等
300100历史过期数据删除失败，请检查异常
300110爬虫数据提取失败，请检查异常
300120爬虫检查更新失败，请检查异常
300130数据读取失败，请检查异常
400001文件类型错误，仅支持 xls|xlsx|csv
400002解析失败，请确认是否按照模板正确填写
400003解析失败，未解析到Licence证书内容
400004证书认证失败，请确认该证书已申请
400005请传入数据类型
400006批量导入数据失败，请检查错误
400007未找到数据
400008数据删除失败，请重试
400009该许可证上传数据条数已达上限
avatar
文章
阅读
粉丝