API de Esdeveniments.cat

Una API REST pública y gratuita con la agenda cultural de Cataluña: eventos, noticias, categorías y lugares, en catalán, castellano e inglés. Úsala en tu app, en tu web o con un agente de IA.

Claves de API

No necesitas ninguna clave. Los endpoints de lectura (GET) son públicos y no piden autenticación. Haz un uso razonable: menos de 60 peticiones por minuto por IP. El servidor MCP lo aplica y, si lo superas, responde con un 429 y la cabecera Retry-After.

Inicio rápido

Haz la primera llamada con curl. Las listas llegan paginadas: si el campo last es false, pide la página siguiente.

# Today's events in Barcelona
curl "https://www.esdeveniments.cat/api/events?place=barcelona&byDate=avui"

# Search events by keyword
curl "https://www.esdeveniments.cat/api/events?term=jazz&size=10"

# One event
curl "https://www.esdeveniments.cat/api/events/{slug}"

Documentación

Prueba la API

Las llamadas de lectura no cambian nada, así que puedes probarlas directamente contra la API de producción. Abre estos ejemplos en el navegador:

Agentes de IA y MCP

Conecta un agente de IA a nuestro servidor MCP, o usa las herramientas WebMCP que la web registra en el navegador.

Servidor MCP de Esdeveniments.cat

Escrituras e idempotencia

El pago de un patrocinio (POST /api/sponsors/checkout) acepta la cabecera Idempotency-Key. Envía una clave nueva (un UUID) en cada intento y repítela si vuelves a probar: solo se crea una sesión de pago.

await fetch("/api/sponsors/checkout", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(), // reuse it on retries
  },
  body: JSON.stringify({ duration: "7days", geoScope: "town", place: "barcelona", placeName: "Barcelona" }),
});

GitHub y contacto

Sigue el proyecto en GitHub o escríbenos si necesitas más datos o un límite más alto.