API d'Esdeveniments.cat

Una API REST pública i gratuïta amb l'agenda cultural de Catalunya: esdeveniments, notícies, categories i llocs, en català, castellà i anglès. Fes-la servir a la teva app, al teu web o amb un agent d'IA.

Claus d'API

No et cal cap clau. Els endpoints de lectura (GET) són públics i no demanen autenticació. Fes-ne un ús raonable: menys de 60 peticions per minut per IP. El servidor MCP ho aplica i, si el passes, respon amb un 429 i la capçalera Retry-After.

Inici ràpid

Fes la primera crida amb curl. Les llistes arriben paginades: si el camp last és false, demana la pàgina següent.

# 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ó

Prova l'API

Les crides de lectura no canvien res, així que les pots provar directament contra l'API de producció. Obre aquests exemples al navegador:

Agents d'IA i MCP

Connecta un agent d'IA al nostre servidor MCP, o fes servir les eines WebMCP que el web registra al navegador.

Servidor MCP d'Esdeveniments.cat

Escriptures i idempotència

El pagament d'un patrocini (POST /api/sponsors/checkout) accepta la capçalera Idempotency-Key. Envia una clau nova (un UUID) a cada intent i repeteix-la si tornes a provar: només es crea una sessió de pagament.

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 i contacte

Segueix el projecte a GitHub o escriu-nos si necessites més dades o un límit més alt.