🌍 全球节假日 API
100+ 国家法定假日 + 中国调休补班（独家数据）
🇨🇳 中国调休补班
🌏 100+ 国家
⚡ <50ms 响应
📦 RESTful
🔑 RapidAPI
为什么用这个 API？
- 中国调休补班数据：其他 API 只返回法定假日，不包含调休补班。我们的数据来自国务院办公厅通知，手动维护，精确到每一天。
- 全球 100+ 国家：基于 python-holidays 开源库，覆盖世界各国法定假日。
- 工作日判断：一个接口判断某天是否工作日（含调休逻辑）。
API 端点
GET/is-workday/{country}/{date}
判断某国某天是否为工作日。中国的调休补班会正确处理。
country: ISO 国家代码 (CN/US/JP/...) · date: YYYY-MM-DD
GET/holidays/{country}/{year}
返回某国某年的所有法定假日列表。中国额外包含调休补班日。
GET/next-holiday/{country}?d=2026-01-01
从指定日期起找下一个法定假日，返回距今天数。
GET/date-range/{country}?start=...&end=...
查询一个日期区间内每天的状态，汇总工作日/假日/周末天数。
GET/china/adjusted-workdays/{year}
中国调休补班日列表（独家数据）。
GET/countries
列出所有支持的国家代码。
调用示例
# 判断 2026-02-14（周六，春节调休补班）是否工作日
curl "http://localhost:8000/is-workday/CN/2026-02-14"
# 返回
{"date":"2026-02-14","weekday":"周六","type":"adjusted_workday",
"name":"调休补班","is_workday":true,"source":"china_override"}
# 查 2026 年中国所有假日和补班日
curl "http://localhost:8000/holidays/CN/2026"
# 返回
{"country":"CN","year":2026,"count":39,"holidays":[
{"date":"2026-01-01","name":"元旦","weekday":"周四"},
{"date":"2026-01-04","name":"调休补班","weekday":"周日"}, ← 独家!
...
]}
定价
与竞品对比
| 特性 | 本 API | Calendarific | Holiday API |
|---|
| 覆盖国家 | 100+ | 230+ | 100+ |
| 中国调休补班 | ✅ 独家 | ❌ | ❌ |
| 工作日判断 | ✅ 含调休 | ❌ | 部分 |
| 起价 | $7/月 | $15/月 | $9/月 |
数据来源
- 全球：python-holidays (vacanza/holidays) 开源库
- 中国调休：国务院办公厅年度通知（手动维护，每年11月更新）
问题反馈
发现数据错误？接口异常？请告诉我们，我们会尽快修复。
Global Holidays API · 阿里云部署 · RapidAPI 上架