Si estás buscando una API de feriados para tu aplicación en Latinoamérica, probablemente encontraste varias opciones. Algunas son gratuitas pero desactualizadas, otras son completas pero caras, otras cubren un solo país.
Este artículo explica qué evaluar para elegir bien según tu caso de uso.
Qué necesitas realmente
Antes de comparar APIs, define qué endpoints vas a usar:
Nivel básico — cualquier app que opera en días laborales:
GET /v1/:country/holidays/:year— lista de feriados de un añoGET /v1/:country/is-business-day?date=— si una fecha es hábil
Nivel intermedio — ecommerce, nómina, logística (requiere Starter, Team o Business):
GET /v1/:country/business-days/add?date=&days=— fecha resultado después de N días hábilesGET /v1/:country/business-days/between?from=&to=— cuántos días hábiles hay entre dos fechasGET /v1/:country/last-business-day?date=— último día hábil del mes
Nivel avanzado — fintech, contratos, operaciones críticas:
- Alertas cuando cambia la legislación de feriados
- Historial de cambios con fuente oficial
- SLA garantizado en el contrato
Si solo necesitas el nivel básico y operas en un país, incluso una lista estática en tu repo puede ser suficiente. La API vale cuando operan múltiples países o cuando el costo de mantener la lista supera el costo de la API.
Qué pasa cuando los datos están desactualizados
Este es el riesgo real. Un feriado extraordinario — por elección, por emergencia, por decreto — puede aparecer con 72 horas de anticipación. Si tu fuente de datos no tiene un mecanismo para detectar y distribuir estos cambios, vas a operar con información incorrecta.
En LATAM esto pasa más seguido de lo que parece. Chile tuvo el plebiscito de 2022 como feriado. Perú declaró feriados regionales. Argentina ha sumado y modificado feriados “puente” en múltiples ocasiones.
La pregunta que hay que hacerle a cualquier API es: ¿cómo sabes cuándo cambia un feriado?
Qué países necesitas
Si tu producto opera en un solo país, el criterio principal es la calidad del dato para ese país. Si operas en varios, el criterio es la consistencia de la interfaz.
Lo que hay que evitar es tener una API para Chile, otra para Colombia y un array hardcodeado para México. Tres fuentes distintas, tres integraciones, tres puntos de falla.
Los 11 países de Latinoamérica con mayor actividad empresarial para considerar:
| País | Complejidad | Razón |
|---|---|---|
| Chile | Media | Feriados fijos, pero con feriados extraordinarios ocasionales |
| Colombia | Alta | Ley Emiliani traslada feriados al lunes siguiente |
| México | Media | Algunos feriados dependen del año electoral |
| Argentina | Alta | Feriados puente variables definidos por decreto cada año |
| Perú | Media | Feriados nacionales más algunos regionales |
| Uruguay | Baja | Calendario estable y predecible |
| Bolivia | Baja | Feriados fijos; solo traslados cuando caen en domingo |
| Ecuador | Media | Ley 2016 define tabla de traslados según día de la semana |
| Costa Rica | Baja | Solo 4 feriados trasladables; el resto son inamovibles |
| Panamá | Baja | Traslados al lunes solo en domingos; Jan 9 y Nov 28 tienen regla extendida |
| Paraguay | Media | Traslados definidos por decreto ejecutivo anual (no algorítmicos) |
Qué ofrece feriados.io
El problema con la mayoría de las APIs de feriados es que son mantenidas manualmente. Alguien actualiza un JSON en GitHub una vez al año. Cuando Argentina declara un feriado puente por decreto en octubre, esa fuente no se entera hasta que alguien lo reporta.
feriados.io monitorea las fuentes legislativas oficiales de cada país de forma automática — BCN en Chile, IMPO en Uruguay, BACN en Paraguay — y distribuye los cambios sin que tengas que hacer nada.
- 11 países con una sola integración: Chile, Colombia, Perú, Uruguay, Paraguay, Bolivia, Ecuador, Costa Rica, Panamá, Argentina y México
- Datos siempre vigentes: si cambia la ley, cambian los datos
- Alertas de cambios legislativos (plan Business): te avisamos cuando se agrega o modifica un feriado en cualquier país
- Plan Free real: 1.000 requests/mes, uso comercial incluido, sin tarjeta
- Interfaz uniforme: el mismo patrón de endpoint funciona para todos los países
# La misma lógica, cualquier país
GET /v1/CL/is-business-day?date=2026-04-03
GET /v1/CO/is-business-day?date=2026-04-03
GET /v1/MX/is-business-day?date=2026-04-03
GET /v1/AR/is-business-day?date=2026-04-03Recomendación por caso de uso
Startup con un solo país: empieza con el plan Free, integra, valida. Cuando necesites los endpoints de lógica operativa (sumar días hábiles, contar entre fechas), el Starter a $9/mes es el siguiente paso natural.
SaaS multi-país: directamente al plan Starter o Team. La cobertura de 11 países con una sola integración justifica el costo desde el primer mes.
Fintech o nómina: evalúa el plan Business por las alertas legislativas. Un feriado que no sabías que existía puede ser más costoso que el plan anual.
API key en 30 segundos, sin tarjeta → feriados.io/register
Ver también: Por qué tu app falla en feriados → · Casos de uso reales → · Documentación →