README.md

今日热榜

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

🚩 特性

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

👀 示例

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

• 今日热榜 - https://hot.imsyy.top/

📊 接口总览

查看全部接口

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

站点	类别	调用名称	状态
哔哩哔哩	热门榜	bilibili
AcFun	排行榜	acfun
微博	热搜榜	weibo
知乎	热榜	zhihu
知乎日报	推荐榜	zhihu-daily
百度	热搜榜	baidu
抖音	热点榜	douyin
快手	热点榜	kuaishou
豆瓣电影	新片榜	douban-movie
豆瓣讨论小组	讨论精选	douban-group
百度贴吧	热议榜	tieba
少数派	热榜	sspai
IT之家	热榜	ithome
IT之家「喜加一」	最新动态	ithome-xijiayi
简书	热门推荐	jianshu
果壳	热门文章	guokr
澎湃新闻	热榜	thepaper
今日头条	热榜	toutiao
36 氪	热榜	36kr
51CTO	推荐榜	51cto
CSDN	排行榜	csdn
NodeSeek	最新动态	nodeseek
稀土掘金	热榜	juejin
腾讯新闻	热点榜	qq-news
新浪网	热榜	sina
新浪新闻	热点榜	sina-news
网易新闻	热点榜	netease-news
吾爱破解	榜单	52pojie
全球主机交流	榜单	hostloc
虎嗅	24小时	huxiu
酷安	热榜	coolapk
虎扑	步行街热帖	hupu
爱范儿	快讯	ifanr
英雄联盟	更新公告	lol
米游社	最新消息	miyoushe
原神	最新消息	genshin
崩坏3	最新动态	honkai
崩坏：星穹铁道	最新动态	starrail
微信读书	飙升榜	weread
NGA	热帖	ngabbs
V2EX	主题榜	v2ex
HelloGitHub	Trending	hellogithub
中央气象台	全国气象预警	weatheralarm
中国地震台	地震速报	earthquake
历史上的今天	月-日	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

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

Vercel 部署

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

Railway 部署

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

Zeabur 部署

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

⚠️ 须知

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

📢 免责声明

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

😘 鸣谢

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

• RSSHub

⭐ Star History