Integrar feriados en Google Calendar, Outlook y Apple Calendar con iCal

La API de feriados.io genera archivos iCalendar estándar (RFC 5545) para todos los países soportados. Eso significa que puedes importar o suscribirte a los feriados de cualquier país directamente desde tu aplicación de calendario — sin copiar fechas a mano.

Dos tipos de uso

Descarga puntual (Free): descarga el archivo .ics del año que necesitas y lo importas una sola vez. Útil para tener los feriados del año en tu calendario personal.

Suscripción permanente (Team/Business): usa una URL permanente que el calendario consulta automáticamente. Cuando hay un feriado nuevo o modificado, tu calendario se actualiza solo en la próxima sincronización.

URLs de los archivos iCal

# Año específico — Free (descarga manual)
https://api.feriados.io/v1/{country}/calendar/{year}

# URL permanente — Team/Business (requiere auth en header)
https://api.feriados.io/v1/{country}/calendar

Ejemplos:

https://api.feriados.io/v1/CL/calendar/2026   → feriados Chile 2026
https://api.feriados.io/v1/CO/calendar/2026   → feriados Colombia 2026
https://api.feriados.io/v1/MX/calendar/2026   → feriados México 2026

Google Calendar

Importación puntual (Free):

1. Abre el .ics desde el browser o descárgalo: https://api.feriados.io/v1/CL/calendar/2026
2. En Google Calendar: panel izquierdo → Otros calendarios → icono + → Importar
3. Selecciona el archivo .ics y elige en qué calendario agregarlo

Suscripción desde URL (Team/Business):

1. Google Calendar → Otros calendarios → + → Desde URL
2. Pega la URL permanente: https://api.feriados.io/v1/CL/calendar

Google Calendar no soporta headers de autenticación en suscripciones por URL. Para la URL permanente, necesitas usar el parámetro api_key que habilitamos en plan Team/Business: https://api.feriados.io/v1/CL/calendar?api_key=frd_tu_key

3. Haz clic en Añadir calendario
4. Google sincroniza cada ~24 horas

Apple Calendar (macOS / iPhone)

macOS:

1. Menú Archivo → Nueva suscripción de calendario…
2. Pega la URL y haz clic en Suscribirse
3. Configura el intervalo de actualización (recomendado: cada día)

iPhone/iPad:

1. Ajustes → Calendario → Cuentas → Añadir cuenta → Otro
2. Añadir calendario con suscripción
3. Pega la URL y confirma

Outlook / Microsoft 365

1. Outlook Calendar → Añadir calendario
2. Selecciona Suscribirse desde la web
3. Pega la URL del .ics y asígnale un nombre (“Feriados Chile 2026”)
4. Haz clic en Importar

Para suscripción con actualización automática en Outlook, usa la URL permanente con el parámetro api_key.

Notion Calendar y otras apps

Cualquier aplicación que soporte el estándar iCalendar (RFC 5545) puede suscribirse. La URL que generamos es compatible con:

• Notion Calendar
• Fantastical
• Calendly (para bloquear días no laborables)
• Home Assistant (automatizaciones basadas en feriados)
• n8n / Zapier (disparadores de flujos)

Usar el iCal desde código

Si necesitas el .ics en tu backend para procesarlo o redirigirlo:

// Node.js — descargar y retornar el ics
app.get('/feriados/:country/:year.ics', async (req, res) => {
  const { country, year } = req.params;
  const upstream = await fetch(
    `https://api.feriados.io/v1/${country}/calendar/${year}`,
    { headers: { Authorization: `Bearer ${process.env.FERIADOS_API_KEY}` } }
  );

  res.setHeader('Content-Type', 'text/calendar');
  res.setHeader('Content-Disposition', `attachment; filename="${country}-${year}.ics"`);
  upstream.body.pipeTo(new WritableStream({ write: chunk => res.write(chunk) }))
    .then(() => res.end());
});

# Python / Django — proxy del ics
import requests
from django.http import HttpResponse

def holidays_ical(request, country, year):
    r = requests.get(
        f"https://api.feriados.io/v1/{country}/calendar/{year}",
        headers={"Authorization": f"Bearer {os.environ['FERIADOS_API_KEY']}"},
    )
    return HttpResponse(r.content, content_type="text/calendar")

Formato del archivo generado

El archivo sigue el estándar RFC 5545 y es compatible con cualquier parser iCal:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Feriados API//feriados.io//ES
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:Feriados Chile 2026
BEGIN:VEVENT
UID:20260101-cl-añ[email protected]
DTSTART;VALUE=DATE:20260101
SUMMARY:Año Nuevo
END:VEVENT
...
END:VCALENDAR

Cada evento tiene un UID único por país/año/nombre, lo que garantiza que las importaciones sucesivas no dupliquen entradas.

Plan Free incluye descarga de iCal por año. Suscripción permanente desde plan Team. Ver planes → · Empezar gratis →

Ver también: Documentación del endpoint calendar → · API de feriados para LATAM → · Integrar feriados en cron jobs →