# Festa'm

> Festa'm (festam.cat) puts the festes majors and local festivals of Catalonia on a map with a time slider: pick a festival, drag the slider and see which acts (concerts, correfocs, castells, children's activities…) are on at that hour and where. It is free for the public, in Catalan, Spanish and English, with a web app (installable PWA), a website with every festival's programme, and a public read-only data API (static JSON).

Festivals are published by town councils, local culture groups and organizers (publishing is paid; reading is free). Each festival edition (e.g. «Festa Major de Terrassa 2026») has a programme of events with category, start and end time (Europe/Madrid), place and coordinates, price (no price = free) and ticket link. Users of the app can also mark favourites and, with an account, share their location or a meeting point with friends; that personal data is never public.

The website is in Catalan at the root (https://festam.cat/), Spanish under /es/ and English under /en/; page slugs are translated in each language.

## Website

- Home: festivals on now and coming up: [ca](https://festam.cat/) · [es](https://festam.cat/es) · [en](https://festam.cat/en)
- How Festa’m works, for the public and for organizers: [ca](https://festam.cat/com-funciona) · [es](https://festam.cat/es/como-funciona) · [en](https://festam.cat/en/how-it-works)
- Guides to the app: map and time slider, friends, sharing your location, favourites, installing, festival information: [ca](https://festam.cat/guies) · [es](https://festam.cat/es/guias) · [en](https://festam.cat/en/guides)
- Frequently asked questions: [ca](https://festam.cat/preguntes-frequents) · [es](https://festam.cat/es/preguntas-frecuentes) · [en](https://festam.cat/en/faq)
- Directory of towns with their festivals: [ca](https://festam.cat/municipis) · [es](https://festam.cat/es/municipios) · [en](https://festam.cat/en/towns)
- Past editions, by year: [ca](https://festam.cat/arxiu) · [es](https://festam.cat/es/archivo) · [en](https://festam.cat/en/archive)
- For town councils: buying a city (exclusive licence), culture groups, approvals: [ca](https://festam.cat/ajuntaments) · [es](https://festam.cat/es/ayuntamientos) · [en](https://festam.cat/en/councils)
- Prices for organizers: plans, extras and AI credit packs: [ca](https://festam.cat/preus) · [es](https://festam.cat/es/precios) · [en](https://festam.cat/en/pricing)
- Contact form: [ca](https://festam.cat/contacte) · [es](https://festam.cat/es/contacto) · [en](https://festam.cat/en/contact)
- Festival pages: `https://festam.cat/festes/<town>/<year>/<slug>` (Catalan), `/es/fiestas/…`, `/en/festivals/…`; each has the whole programme and schema.org Festival JSON-LD.
- [Sitemap](https://festam.cat/sitemap.xml): every indexable page in the three languages.

## App

- [Festa'm app](https://app.festam.cat/): the map with the time slider, festival lists, favourites and friends. A web app (PWA), no download needed.
- Festival in the app: `https://app.festam.cat/fiestas/<slug>`; one event: `https://app.festam.cat/fiestas/<slug>?evento=<eventId>`.

## Public data API

- [OpenAPI description](https://festam.cat/openapi.json): every file and its JSON Schema.
- Base URL: https://api.festam.cat/data/v1/ — read-only static JSON, GET only, no authentication, CORS `*`, refreshed within minutes of a change (CDN, `s-maxage=300`).
- [All current festivals](https://api.festam.cat/data/v1/all.json), [next 100](https://api.festam.cat/data/v1/upcoming.json), [past editions](https://api.festam.cat/data/v1/archive.json).
- A festival: `https://api.festam.cat/data/v1/festivals/<id>.json` or `https://api.festam.cat/data/v1/festival-slugs/<slug>.json`; its programme: `https://api.festam.cat/data/v1/festivals/<id>/events.json` (ended events included).
- [Towns](https://api.festam.cat/data/v1/municipalities.json), [event categories](https://api.festam.cat/data/v1/categories.json).
- Times are UTC (ISO 8601); festivals happen in Europe/Madrid. Coordinates are GeoJSON [longitude, latitude].
- Town and locality data (names, codes, locations): Idescat and ICGC, CC BY 4.0. Festival content belongs to its organizers; link back to the festival page when you quote it.

## Optional

- [Full text for AI readers](https://festam.cat/llms-full.txt): every published festival with dates, town, categories and links, the towns with festivals, and the guides’ text.
- [Map cells](https://api.festam.cat/data/v1/tiles.json) and `https://api.festam.cat/data/v1/tiles/<y>_<x>.json`: festivals by 0.5° cell, as the app reads them.
- [Towns and localities, compact](https://api.festam.cat/data/v1/places.json): rows `[id, kind, name, municipalityId, lat, lng, population]`.
- [Public prices](https://api.festam.cat/data/v1/plans.json).
- Terms of use: [ca](https://festam.cat/condicions) · [es](https://festam.cat/es/condiciones) · [en](https://festam.cat/en/terms) · Privacy: [ca](https://festam.cat/privacitat) · [es](https://festam.cat/es/privacidad) · [en](https://festam.cat/en/privacy)