🚩 特性

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

👀 示例

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

• 今日热榜 - https://hot.imsyy.top/
• 每日热搜 - https://hot.guole.fun/

📊 接口总览

🟢 状态正常 / 🟠 可能失效 / ❌ 无法使用 / ⚠️ 需要科学上网

示例站点运行于海外服务器，部分国内站点可能存在访问异常，请以实际情况为准 | 站点 | 类别 | 调用名称 | 状态 | |------------------|--------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 哔哩哔哩 | 热门榜 | 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 | |
| Github 提交日历 | 用户名 | github-calendar | |
| 哔哔闪念 | 最近哔哔 | bbtalk | |
| 必应 | 每日一图 | bing | |
| 高德天气 | 高德天气信息 | gaode-weather | |
| IP | 利用 vercel 返回 IP 信息 | ip | |
| umami | 查询 umami 网站统计数据 | umami | |

⚙️ 使用

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

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

pnpm add guole.fun.api

import serveHotApi from "guole.fun.api";

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

⚙️ 部署

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

Docker 部署

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

本地构建

# 构建
docker build -t guole.fun.api .

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

在线部署

# 拉取
docker pull kuole-o/guole.fun.api:latest

# 运行
docker run --restart always -p 6688:6688 -d kuole-o/guole.fun.api:latest

手动部署

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

安装

git clone https://github.com/kuole-o/api.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 进行一键部署，点击下方按钮或前往 项目仓库 进行手动部署

Railway 部署

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

Zeabur 部署

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

⚠️ 须知

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

📢 免责声明

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

😘 鸣谢

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

• RSSHub

⭐ Star History