Calendarific

简介

Calendarific 通过基于密钥的 API 提供 230+ 个国家和 3,000+ 个地区的公共节假日——日期、名称、当地名称、类型和星期信息。是多国节假日功能的热门选择（无效密钥返回 401——已实测）。

快速开始

某国某年的节假日（替换 YOUR_KEY）：

curl "https://calendarific.com/api/v2/holidays?api_key=YOUR_KEY&country=US&year=2026"

{
  "response": {
    "holidays": [
      {
        "name": "New Year's Day",
        "date": { "iso": "2026-01-01" },
        "type": ["National holiday"],
        "country": { "id": "US", "name": "United States" },
        "locations": "All",
        "states": "All"
      }
    ]
  }
}

指定月份：

curl "https://calendarific.com/api/v2/holidays?api_key=YOUR_KEY&country=CN&year=2026&month=10"

认证方式

• 在 calendarific.com 注册获取免费 API 密钥（邮件发送）。
• 通过 api_key 查询参数携带（无效密钥返回 401——已实测）。

速率限制与注意事项

• 免费层：1,000 次请求/月（每次响应最多 100 个假日）；付费档可扩展。
• 覆盖 230+ 个国家；locations/states 字段表示区域范围。
• 假日类型含 National、Observance、Season、Religious 等。
• 响应含 weekday 信息（日期/名称）和 date.datetime 字段。

常见问题

Calendarific 免费吗？ 免费层：1,000 次/月；更多需要付费。

如何获取密钥？ 在 calendarific.com 注册——密钥会邮件发送。

覆盖多少国家？ 230+ 个国家和 3,000+ 个地区。