系列「每天一个高质量 API」第 16 篇。搜蚁智选（souyi.net.cn）是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 Nager.Date 公共假日（free-holiday-nagerdate）。
给定年份和国家，返回全年法定假日——中国的还会带上「元旦 / 春节 / 劳动节」这样的中文名。
这个 API 能做什么
/api/v3/PublicHolidays/{year}/{country} 按国家返回全年假日：date、localName（本地语言，中国返回中文）、name（英文）、types（Public / Bank / Observance）、counties（是否只适用于部分行政区）。2026 年中国返回 6 条法定假日。
为什么 AI Agent 需要它
- 日程 / 排期 Agent：把会议、发布、结算避开法定假日。
- 跨境业务：一次循环拉十几个国家，做全球工作日历。
- SLA 计算：扣掉假日才能算准「工作日」。
怎么用
方式一：直连上游（免费、无需 Key）
curl "https://date.nager.at/api/v3/PublicHolidays/2026/CN"方式二：经搜蚁智选一键调用（带 Key，统一计费 / 限流 / 可观测）
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"free-holiday-nagerdate","call_data":{"year":2026,"country":"CN"}}'这些免费 API 的上游本身免密；经搜蚁智选代理后，多个数据源可以聚合到同一个 Agent 工作流里，统一走 X-API-Key + 统一计费、限流与可观测，省去每个上游单独接一遍。
返回示例
[
{
"date": "2026-01-01",
"localName": "元旦",
"name": "New Year's Day",
"countryCode": "CN",
"global": true,
"types": ["Public"]
},
{
"date": "2026-02-17",
"localName": "春节",
"name": "Chinese New Year (Spring Festival)",
"countryCode": "CN",
"global": true,
"types": ["Public"]
},
{
"date": "2026-05-01",
"localName": "劳动节",
"name": "Labour Day",
"countryCode": "CN",
"global": true,
"types": ["Public"]
}
]价格
免费。Nager.Date 无 Key，覆盖 100+ 国家；平台按 {{year}} / {{country}} 模板传参。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API（含本系列 22 个）。
小结
这个接口的杀手锏是 localName——它返回的是当地人真正在过的节日名。排期、结算、提醒类 Agent 接上它，就能少犯「把会议排在春节」这种错。
更多免费 API 见 系列目录。