API de Festivos
API JSON gratuita para datos de festivos. 199 países, 6 idiomas, 2024-2030. Sin clave API.
Endpoints
/api/v1/holidays Obtener los festivos de un país y año específicos.
Parámetros
| Parámetro | Obligatorio | Descripción |
|---|---|---|
country | Sí | Código de país ISO 3166-1 alfa-2 (ej. TR, US, DE) |
year | Sí | Año entre 2024-2030 |
type | No | Filtrar por tipo: public, bank, observance, religious |
lang | No | Idioma: en, tr, de, es, fr, pt (predeterminado: en) |
Ejemplo
https://holidaycalendar.pages.dev/api/v1/holidays?country=TR&year=2026&lang=tr Respuesta
{
"holidays": [
{
"date": "2026-01-01",
"name": "Yılbaşı",
"type": "public"
},
{
"date": "2026-03-19",
"name": "Ramazan Bayramı Arifesi",
"type": "public"
}
],
"meta": {
"country": "TR",
"year": 2026,
"total": 16,
"types": { "public": 16 }
}
} /api/v1/countries Listar todos los países compatibles con códigos, nombres y continente.
Parámetros
| Parámetro | Obligatorio | Descripción |
|---|---|---|
lang | No | Idioma para nombres de países (predeterminado: en) |
Ejemplo
https://holidaycalendar.pages.dev/api/v1/countries?lang=en /api/v1/calendar/[country].ics Descargar un archivo de calendario ICS para un país. Usar como URL de suscripción en apps de calendario.
Parámetros
| Parámetro | Obligatorio | Descripción |
|---|---|---|
year | No | Año (predeterminado: año actual) |
lang | No | Idioma para nombres de festivos (predeterminado: en) |
Ejemplo
https://holidaycalendar.pages.dev/api/v1/calendar/TR.ics?year=2026&lang=tr Inicio rápido
Sin clave API, sin registro. Solo envía una solicitud HTTP GET.
const res = await fetch( 'https://holidaycalendar.pages.dev/api/v1/holidays?country=US&year=2026' ); const data = await res.json(); console.log(data.holidays);
import requests
r = requests.get(
'https://holidaycalendar.pages.dev/api/v1/holidays',
params={'country': 'US', 'year': 2026}
)
holidays = r.json()['holidays'] Detalles
Todos los endpoints devuelven JSON con codificación UTF-8. El endpoint ICS devuelve text/calendar.
Las respuestas incluyen cabeceras Cache-Control (24 h). Los datos de festivos rara vez cambian dentro de un año.
Las solicitudes cross-origin son compatibles. Llama a la API directamente desde JavaScript del navegador.
Sin límites estrictos para uso razonable. Por favor, almacena en caché las respuestas en tu lado para apps de alto tráfico.
Preguntas frecuentes
Es gratuita la API?
Sí. Completamente gratuita, sin clave API, sin registro y sin límites de uso para un uso razonable.
Qué formatos de datos están disponibles?
JSON para los endpoints de festivos y países, ICS (iCalendar) para feeds de calendario. Todo el texto está codificado en UTF-8.
Cuántos países son compatibles?
199 países y territorios en 6 continentes, con datos desde 2024 hasta 2030.
Puedo usarla en proyectos comerciales?
Sí. La API es gratuita tanto para uso personal como comercial. Agradecemos un enlace de vuelta, pero no es obligatorio.
Hay un límite de uso?
No hay un límite estricto, pero por favor almacena en caché las respuestas para aplicaciones de alto tráfico. Las respuestas incluyen una cabecera Cache-Control de 24 horas.