Global Holidays & Events API

Discover public holidays and events for any country and year.

支持检索任意国家及任意年份的公共节假日与公共活动信息

原始信息汇总

Global Holidays & Events API 数据集概述

基本信息

• API名称: Global Holidays & Events API
• 提供平台: RapidAPI
• API创建者: Abhishek
• 类别: Events
• 当前版本: v1
• 基础计划价格: $0.00 / 月

服务指标

• 流行度: 8.6
• 服务等级: 100%
• 延迟: 1235ms
• 测试通过率: 100%

功能描述

获取任何国家和年份的公共假期、节日和关键事件的全面列表。功能包括识别即将到来的假期和长周末，适用于日历应用、调度工具或事件平台。

主要特性

• 全球国家支持
• 按国家和年份提供公共假期
• 显示距下一个即将到来的假期的天数
• 长周末检测（周五/周一的假期）
• 快速的JSON响应
• 安全访问

接口端点

• 方法: GET
• 路径: https://global-holidays-events-api.p.rapidapi.com/

查询参数

参数名	类型	是否必需	描述
country	string	是	ISO 国家代码（例如 US, GB）
year	number	是	年份（从 1900 年开始）

示例请求

javascript const axios = require(axios); const options = { method: GET, url: https://global-holidays-events-api.p.rapidapi.com/, params: { country: US, year: 2025 }, headers: { X-RapidAPI-Key: YOUR_API_KEY, X-RapidAPI-Host: global-holidays-events-api.p.rapidapi.com } };

响应结构

响应为JSON格式，主要包含以下字段：

• country: 查询的国家代码
• year: 查询的年份
• count: 假期数量
• holidays: 假期对象数组（包含 date, name, type）
• nextHoliday: 下一个即将到来的假期信息（包含 date, name, daysUntil）
• longWeekends: 长周末数组（包含 date, name）

错误响应

• 无效请求 (400): { "error": "Invalid or unsupported country/year" }
• 服务器错误 (500): { "error": "Internal Server Error" }

支持的国家

API支持使用ISO国家代码查询多个国家的假期，包括但不限于：AD（安道尔）、AL（阿尔巴尼亚）、AR（阿根廷）、AT（奥地利）、AU（澳大利亚）、BE（比利时）、BR（巴西）、CA（加拿大）、CN（中国）、DE（德国）、FR（法国）、GB（英国）、IT（意大利）、JP（日本）、KR（韩国）、RU（俄罗斯）、US（美国）等。

典型应用场景

• 日历与调度应用
• 人力资源与薪酬系统
• 旅行与预订平台
• 分析与报告工具
• 需要全球假期数据的SaaS产品

优势

• 清晰且可预测的响应
• 无需设置或配置
• 生产就绪
• 具有成本效益的定价
• 易于扩展

搜集汇总

背景与挑战

背景概述

该API提供全球各国任意年份的公共节假日和活动信息查询服务。