README.md

January 14, 2025 · View on GitHub

logo

今日热榜

一个聚合热门数据的 API 接口


last commit code size docker-image-size Publish Docker image Publish npm package

🚩 特性

  • 极快响应,便于开发
  • 支持 RSS 模式和 JSON 模式
  • 支持多种部署方式
  • 简明的路由目录,便于新增

👀 示例

这里是使用该 API 的示例站点
示例站点可能由于访问量或者长久未维护而访问异常
若您也使用了本 API 搭建了网站,欢迎提交您的站点链接

📊 接口总览

查看全部接口

示例站点运行于海外服务器,部分国内站点可能存在访问异常,请以实际情况为准

站点类别调用名称状态
哔哩哔哩热门榜bilibilihttps://api-hot.imsyy.top/bilibili
AcFun排行榜acfunhttps://api-hot.imsyy.top/acfun
微博热搜榜weibohttps://api-hot.imsyy.top/weibo
知乎热榜zhihuhttps://api-hot.imsyy.top/zhihu
知乎日报推荐榜zhihu-dailyhttps://api-hot.imsyy.top/zhihu-daily
百度热搜榜baiduhttps://api-hot.imsyy.top/baidu
抖音热点榜douyinhttps://api-hot.imsyy.top/douyin
快手热点榜kuaishouhttps://api-hot.imsyy.top/kuaishou
豆瓣电影新片榜douban-moviehttps://api-hot.imsyy.top/douban-movie
豆瓣讨论小组讨论精选douban-grouphttps://api-hot.imsyy.top/douban-group
百度贴吧热议榜tiebahttps://api-hot.imsyy.top/tieba
少数派热榜sspaihttps://api-hot.imsyy.top/sspai
IT之家热榜ithomehttps://api-hot.imsyy.top/ithome
IT之家「喜加一」最新动态ithome-xijiayihttps://api-hot.imsyy.top/ithome-xijiayi
简书热门推荐jianshuhttps://api-hot.imsyy.top/jianshu
果壳热门文章guokrhttps://api-hot.imsyy.top/guokr
澎湃新闻热榜thepaperhttps://api-hot.imsyy.top/thepaper
今日头条热榜toutiaohttps://api-hot.imsyy.top/toutiao
36 氪热榜36krhttps://api-hot.imsyy.top/36kr
51CTO推荐榜51ctohttps://api-hot.imsyy.top/51cto
CSDN排行榜csdnhttps://api-hot.imsyy.top/csdn
NodeSeek最新动态nodeseekhttps://api-hot.imsyy.top/nodeseek
稀土掘金热榜juejinhttps://api-hot.imsyy.top/juejin
腾讯新闻热点榜qq-newshttps://api-hot.imsyy.top/qq-news
新浪网热榜sinahttps://api-hot.imsyy.top/sina
新浪新闻热点榜sina-newshttps://api-hot.imsyy.top/sina-news
网易新闻热点榜netease-newshttps://api-hot.imsyy.top/netease-news
吾爱破解榜单52pojiehttps://api-hot.imsyy.top/52pojie
全球主机交流榜单hostlochttps://api-hot.imsyy.top/hostloc
虎嗅24小时huxiuhttps://api-hot.imsyy.top/huxiu
酷安热榜coolapkhttps://api-hot.imsyy.top/coolapk
虎扑步行街热帖hupuhttps://api-hot.imsyy.top/hupu
爱范儿快讯ifanrhttps://api-hot.imsyy.top/ifanr
英雄联盟更新公告lolhttps://api-hot.imsyy.top/lol
米游社最新消息miyoushehttps://api-hot.imsyy.top/miyoushe
原神最新消息genshinhttps://api-hot.imsyy.top/genshin
崩坏3最新动态honkaihttps://api-hot.imsyy.top/honkai
崩坏:星穹铁道最新动态starrailhttps://api-hot.imsyy.top/starrail
微信读书飙升榜wereadhttps://api-hot.imsyy.top/weread
NGA热帖ngabbshttps://api-hot.imsyy.top/ngabbs
V2EX主题榜v2exhttps://api-hot.imsyy.top/v2ex
HelloGitHubTrendinghellogithubhttps://api-hot.imsyy.top/hellogithub
中央气象台全国气象预警weatheralarmhttps://api-hot.imsyy.top/weatheralarm
中国地震台地震速报earthquakehttps://api-hot.imsyy.top/earthquake
历史上的今天月-日historyhttps://api-hot.imsyy.top/history

⚙️ 使用

本项目支持 Node.js 调用,可在安装完成后调用 serveHotApi 来开启服务器

该方式无法使用部分需要 Puppeteer 环境的接口

pnpm add dailyhot-api
import serveHotApi from "dailyhot-api";

/**
 * 启动服务器
 * @param {Number} [port] - 端口号
 * @returns {Promise<void>}
 */
serveHotApi(3000);

⚙️ 部署

具体使用说明可参考 我的博客,下方仅讲解基础操作:

Docker 部署

安装及配置 Docker 将不在此处说明,请自行解决

本地构建

# 构建
docker build -t dailyhot-api .

# 运行
docker run --restart always -p 6688:6688 -d dailyhot-api
# 或使用 Docker Compose
docker-compose up -d

在线部署

# 拉取
docker pull imsyy/dailyhot-api:latest

# 运行
docker run --restart always -p 6688:6688 -d imsyy/dailyhot-api:latest

手动部署

最直接的方式,您可以按照以下步骤将 DailyHotApi 部署在您的电脑、服务器或者其他任何地方

安装

git clone https://github.com/imsyy/DailyHotApi.git
cd DailyHotApi

然后再执行安装依赖

npm install

复制 /.env.example 文件并重命名为 /.env 并修改配置

开发

npm run dev

成功启动后程序会在控制台输出可访问的地址

编译运行

npm run build
npm run start

pm2 部署

npm i pm2 -g
sh ./deploy.sh

成功启动后程序会在控制台输出可访问的地址

Vercel 部署

本项目支持通过 Vercel 进行一键部署,点击下方按钮或前往 项目仓库 进行手动部署

Deploy with Vercel

Railway 部署

本项目支持使用 Railway 一键部署,请先将本项目 fork 到您的仓库中,即可使用一键部署。

Zeabur 部署

本项目支持使用 Zeabur 一键部署,请先将本项目 fork 到您的仓库中,即可使用一键部署。

⚠️ 须知

  • 本项目为了避免频繁请求官方数据,默认对数据做了缓存处理,默认为 60 分钟,如需更改,请自行修改配置
  • 本项目部分接口使用了 页面爬虫,若违反对应页面的相关规则,请 及时通知我去除该接口

📢 免责声明

  • 本项目提供的 API 仅供开发者进行技术研究和开发测试使用。使用该 API 获取的信息仅供参考,不代表本项目对信息的准确性、可靠性、合法性、完整性作出任何承诺或保证。本项目不对任何因使用该 API 获取信息而导致的任何直接或间接损失负责。本项目保留随时更改 API 接口地址、接口协议、接口参数及其他相关内容的权利。本项目对使用者使用 API 的行为不承担任何直接或间接的法律责任
  • 本项目并未与相关信息提供方建立任何关联或合作关系,获取的信息均来自公开渠道,如因使用该 API 获取信息而产生的任何法律责任,由使用者自行承担
  • 本项目对使用 API 获取的信息进行了最大限度的筛选和整理,但不保证信息的准确性和完整性。使用 API 获取信息时,请务必自行核实信息的真实性和可靠性,谨慎处理相关事项
  • 本项目保留对 API 的随时更改、停用、限制使用等措施的权利。任何因使用本 API 产生的损失,本项目不负担任何赔偿和责任

😘 鸣谢

特此感谢为本项目提供支持与灵感的项目

⭐ Star History

Star History Chart