Días Festivos Públicos API
Consulta los días festivos públicos de más de 100 países y de cualquier año en una sola llamada a la API. Cómputo totalmente local: sin fuentes de datos externas, sin sorpresas con los límites de tasa.
¿No tienes una clave API?
Inicia sesión en tu cuenta para crear y gestionar tus claves API.
Guía de integración
Copia un fragmento, sustituye tu clave de API y ejecútalo. Funciona en cualquier cliente HTTP — ejemplos abajo en cURL, JavaScript y Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringobligatorioISO 3166-1 alpha-2 country code US
yearintegeropcional4-digit year (defaults to current year) 2026
curl -X GET "https://www.apipick.com/api/holidays" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "Holidays retrieved successfully",
"data": {
"country": "US",
"country_name": "United States",
"year": 2026,
"total": 11,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day"
},
{
"date": "2026-01-19",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2026-02-16",
"name": "Presidents' Day"
},
{
"date": "2026-05-25",
"name": "Memorial Day"
},
{
"date": "2026-07-03",
"name": "Independence Day (observed)"
},
{
"date": "2026-09-07",
"name": "Labor Day"
},
{
"date": "2026-10-12",
"name": "Columbus Day"
},
{
"date": "2026-11-11",
"name": "Veterans Day"
},
{
"date": "2026-11-26",
"name": "Thanksgiving Day"
},
{
"date": "2026-12-25",
"name": "Christmas Day"
}
]
},
"credits_used": 1,
"remaining_credits": 99
}Diseñada para la planificación del mundo real
Planificación de RR. HH.
Excluye automáticamente los días festivos al calcular saldos de vacaciones, ciclos de nóminas y cuadrantes de turnos en varios países.
Calendarios de trading
Omite los días sin negociación en modelos financieros y backtests. Identifica los festivos bancarios que afectan a las ventanas de liquidación y compensación.
ETAs de logística
Calcula estimaciones de entrega precisas omitiendo automáticamente los festivos en los países de origen, tránsito y destino.
Automatización con n8n
Conéctalo a flujos de n8n o Zapier para condicionar acciones sensibles al tiempo: omite el envío de emails o informes en festivos nacionales.
Alternativa a HolidayAPI y Nager.Date
Datos del año en curso, planificación de años futuros y un SLA de producción, sin el bloqueo de año del plan gratuito ni el riesgo de fiabilidad de un proyecto comunitario.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Plan gratuito | Solo año anterior | Gratis (sin SLA) | 100 créditos al registrarte |
| Datos del año en curso | Solo plan de pago | ✓ | ✓ |
| Datos de años futuros | Solo plan de pago | ✓ (limitado) | ✓ hasta +10 años |
| Datos históricos (desde 1900) | Solo plan de pago | Parcial | ✓ desde 1900 |
| SLA de producción | Solo planes de pago | ✗ Proyecto comunitario | ✓ |
| Países cubiertos | ~100 | ~110 | 100+ |
| Sin tarjeta de crédito para empezar | ✗ | ✓ | ✓ |
| ¿Caducan los créditos / las solicitudes? | Plan anual | N/A | Nunca caducan |
| Listo para agentes de IA / LLM | Parcial | Parcial | ✓ JSON nativo |
La trampa del plan gratuito de HolidayAPI
El plan gratuito de HolidayAPI está limitado intencionadamente solo al año natural anterior. ¿Necesitas consultar los festivos del año en curso o planificar con antelación los calendarios de vacaciones de 2027? Tienes que pasar a un plan de pago. Para cualquier caso de uso de planificación o automatización, esto deja el plan gratuito prácticamente inservible desde el primer día.
El riesgo de fiabilidad de Nager.Date
Nager.Date es un proyecto de código abierto mantenido por la comunidad: gratuito, pero sin SLA de disponibilidad, sin contrato de soporte y sin garantía de continuidad. Equipos que han construido sistemas de nóminas o pipelines de logística sobre él se han visto sorprendidos por caídas inesperadas o por su descontinuación. Está bien para prototipar; no para producción.
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| data.country | string | Código de país ISO 3166-1 alpha-2 (en mayúsculas) |
| data.country_name | string | Nombre completo del país en inglés |
| data.year | integer | El año natural consultado |
| data.total | integer | Número de días festivos públicos del año |
| data.holidays | array | Lista de objetos de festivo ordenados por fecha |
| data.holidays[].date | string | Fecha del festivo en formato YYYY-MM-DD |
| data.holidays[].name | string | Nombre oficial del festivo |
| credits_used | integer | Créditos descontados por esta solicitud |
| remaining_credits | integer | Créditos restantes en tu cuenta |
Límites de tasa
La limitación es por clave de API, ventana deslizante de 60 segundos. Al alcanzar el límite recibes un 429 limpio con una cabecera Retry-After.
120req/min
Por clave de API, por endpoint. Ventana deslizante de 60 segundos.
3concurrent
Máximo de peticiones simultáneas en curso por clave de API.
X-RateLimit-LimitMáximo de peticiones permitidas por minutoX-RateLimit-RemainingPeticiones restantes en la ventana actualX-RateLimit-ResetSegundos hasta que se reinicia la ventana actualRetry-AfterSegundos a esperar antes de reintentar (solo en 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Preguntas frecuentes
P: ¿Qué países se admiten?
R: Más de 100 países a través de la librería de código abierto python-holidays (vacanza). Esto incluye EE. UU., Reino Unido, Alemania, Francia, Japón, China, Australia, Canadá, India, Brasil y la mayor parte de Europa, Asia, Latinoamérica y África. Usa un código ISO 3166-1 alpha-2 válido (p. ej. US, GB, DE).
P: ¿Hasta dónde puedo consultar hacia atrás y hacia adelante?
R: Puedes consultar cualquier año desde 1900 hasta 10 años en el futuro. Los festivos históricos se calculan según las reglas que estaban en vigor en su momento, de modo que los resultados reflejan las observancias históricas reales en lugar de proyectar hacia atrás las reglas actuales.
P: ¿Se incluyen los festivos regionales o autonómicos?
R: Este endpoint devuelve únicamente festivos públicos nacionales. Las observancias específicas de estado, provincia o región (p. ej. festivos estatales de EE. UU., festivos de los Länder alemanes) no se incluyen en la respuesta por defecto. Contáctanos si necesitas datos de festivos a nivel de subdivisión.
P: ¿Pueden los agentes de IA usar esto como herramienta?
R: Sí. El endpoint toma dos parámetros de consulta (country y year) y devuelve un array JSON estructurado, sencillo de definir como herramienta de función para OpenAI, Claude, LangChain o cualquier framework de agentes. Ideal para agentes de planificación que necesitan razonar sobre los días laborables en varios países.
Usa los Días Festivos Públicos en Claude Code y agentes de IA
Instala la skill oficial de Claude Code para consultar los días festivos públicos de más de 100 países directamente dentro de tu agente de programación con IA: fechas ordenadas, nombres oficiales y recuentos mediante lenguaje natural.
Pregunta a tu agente de IA con naturalidad
Plataformas compatibles
Skill de Claude Code para la API Días Festivos Públicos de APIpick
Devuelve listas de festivos ordenadas por fecha con nombres oficiales en inglés y recuentos totales para más de 100 países. Admite años desde 1900 hasta 10 años por delante.