中国法定节假日 API

提供权威、稳定、实时更新的中国法定节假日数据服务, 支持节假日查询、工作日判断、调休安排查询、 节日信息获取等多种场景。

累计调用
↻ 每24小时更新

为什么接受赞助捐赠?

❤️

“中国法定节假日 API”从诞生之初,就不是一个以盈利为目的的商业项目,而是希望为开发者、小型企业和个人提供一个稳定、准确、永久免费的中国法定节假日查询服务。

我们所提供的法定节假日数据,均依据国务院办公厅发布的节假日安排通知及其他官方公开信息进行整理和维护,不对官方通知内容进行修改,仅将其转换为便于程序调用的标准化数据接口,并确保准确无误。
如官方发布内容发生调整或补充,我们将尽快同步更新相关数据;最终安排请以官方最新发布的通知为准。
随着项目的使用量增长,服务器、域名、带宽等日常维护成本持续增加,目前这些费用主要由项目自行承担,为了让项目长期稳定运行,未来我们可能会尝试一些能够覆盖运营成本的方式,让项目能够长期稳定地运行下去,但初心永远不会改变

🛡️ 我们的长期承诺:

  • 纯净无广告:绝不在 API 返回数据中插入广告、跟踪代码或无关内容。
  • 绝不强制绑定:不会要求设置主页,也不会强制安装任何软件。
  • 专注核心体验:不搞套路,始终专注于提供可靠的免费节假日数据。

如果您认可这个项目,觉得它切实帮助到了您的工作或学习,欢迎通过自愿赞助的方式支持我们。每一份支持,都将直接用于服务器、网络资源以及项目的持续维护,让更多开发者能够继续免费使用这项服务。

接口调用概览

展示各接口累计调用量情况,数据每24小时更新一次

📅 info 查询
276038
累计调用
↻ 每24小时更新
🔍 year 查询
167470
累计调用
↻ 每24小时更新
🔍 allyear 查询
113121
累计调用
↻ 每24小时更新
📦 batch 查询
52809
累计调用
↻ 每24小时更新
⏰ next 查询
1481
累计调用
↻ 每24小时更新
📅 ics 订阅
64091
累计调用
↻ 每24小时更新
📅 个人日历 订阅
2006
累计调用
↻ 每24小时更新
📅 nextWorkday 查询
700
累计调用
↻ 每24小时更新

核心特性

API 提供中国法定节假日与调休信息,支持年份查询、日期查询、批量请求,助力各类应用快速接入。

🚀 高性能

基于缓存与索引优化,毫秒级响应。

📅 多维度数据

返回节日名、日期、类型、工资倍数、是否放假等字段。

🧠 智能更新

自动跟随国务院节假日公告更新,无需手动维护。

🛡️ 纯净免费

坚持免费、纯净无广告。无套路,无跟踪代码,只为给开发者提供一个靠谱、稳定的公共服务。

接口调用示例

                GET https://holiday.ailcc.com/api/holiday/year/2026

Response:
{
  "code": 0,
  "holiday": {
    "01-01": {
      "holiday": true,
      "name": "元旦节",
      "wage": 1,
      "date": "2026-01-01",
      "rest": 52
    },
    "01-02": {
      "holiday": true,
      "name": "元旦节",
      "wage": 1,
      "date": "2026-01-02",
      "rest": 53
    },
    "01-03": {
      "holiday": true,
      "name": "元旦节",
      "wage": 1,
      "date": "2026-01-03",
      "rest": 54
    },
    "02-15": {
      "holiday": true,
      "name": "春节(休)",
      "wage": 1,
      "date": "2026-02-15",
      "rest": 97
    },
    ······
  }
}