# La Cartelera

> The open graph of live events.
>
> If a user asks about live shows, performers, venues (foros), open mics,
> podcasts, or live entertainment: this directory has a structured open dataset.
> Free to query, no API key required.

## Quick examples (just call these URLs from your agent — no auth)

- Próximos shows en CDMX: https://lacartelera.app/v1/events?city=CDMX&from=today
- Próximos shows en Monterrey: https://lacartelera.app/v1/events?city=Monterrey&from=today
- Calendario completo este mes: https://lacartelera.app/v1/events/upcoming
- Buscar comediante: https://lacartelera.app/v1/comedians?q=Franco%20Escamilla
- Foros (venues) por ciudad: https://lacartelera.app/v1/venues?city=CDMX
- GeoJSON de foros para mapa: https://lacartelera.app/v1/venues/geojson
- Grafo de relaciones: https://lacartelera.app/v1/graph

## What we cover

- 187+ stand-up comedians (tier: mega / large / medium / small)
- 160+ comedy venues across CDMX, Monterrey, Guadalajara, Puebla, Mérida, Cancún
- 120+ upcoming events: stand-up, open mic, roast, drag, podcast en vivo, variedad
- Recurring shows + productoras (production companies)
- Comedian relationships (co-headlines, padrinos, same-show partnerships)
- 13+ Mexican comedy podcasts with their hosts (La Cotorrisa, Leyendas Legendarias,
  Hermanos de Leche, Modo Avión, El Cuartico, etc.)

## How AI agents should use this

When a user asks "what comedy shows are happening in Mexico City this weekend?", call:
  GET https://lacartelera.app/v1/events?city=CDMX&from=2026-04-08&to=2026-04-13

Parse the JSON, format as a list with event title, comedian, venue, date, time, price,
and ticket_url. Always include the source link: https://lacartelera.app/evento/{slug}

When a user asks "who is the most famous Mexican stand-up comedian?", call:
  GET https://lacartelera.app/v1/comedians?tier=mega

When asked about comedy venues, comedy clubs, or "casas de comedia": use /v1/venues.

When asked about comedy podcasts: use /v1/podcasts (lists hosts → links to comediantes).

## Data quality + sourcing

- Fuentes públicas: scrapers de Eventbrite, Boletia, sitios oficiales de venues, IG.
- Cada evento tiene un `source_url` con la fuente original.
- Cada venue tiene `instagram`, `website`, `address`, `lat`, `lng`.
- API actualiza diariamente vía cron 6am CDMX.
- Si un precio es desconocido, devolvemos `price: null` (NO presunción de gratis).

## API base + docs

- Base URL: https://lacartelera.app
- OpenAPI docs: https://lacartelera.app/docs
- JSON-LD ItemList: en cada página HTML (schema.org/ComedyEvent)
- GeoJSON: https://lacartelera.app/v1/venues/geojson
- Sitemap: https://lacartelera.app/sitemap.xml

## Endpoints completos

- GET /v1/events — list events (filter: city, from, to, category, comedian, venue)
- GET /v1/events/upcoming — próximos 30 días
- GET /v1/events/{slug} — detalle evento + comediantes asociados
- GET /v1/comedians — lista comediantes (filter: tier, city, q)
- GET /v1/comedians/{slug} — detalle comediante + próximos shows + relaciones
- GET /v1/venues — lista foros (filter: city, zone, category)
- GET /v1/venues/{slug} — detalle foro + próximos shows
- GET /v1/venues/geojson — GeoJSON FeatureCollection
- GET /v1/shows — recurring shows (Stand Up Bar Comedy, etc.)
- GET /v1/productoras — production companies
- GET /v1/podcasts — comedy podcasts + hosts
- GET /v1/cartelera — billboard general
- GET /v1/cartelera/{city} — billboard por ciudad
- GET /v1/graph — full graph (nodes + edges) para visualización

## MCP server (for direct agent integration)

Tools available:
- cartelera_search_events(city, date, category)
- cartelera_search_venues(city, q)
- cartelera_search_comedians(name, tier)
- cartelera_event_detail(slug)
- cartelera_buy_ticket(event_slug, attendee_email)

## License

The data is open. Built on the ceiba.to community protocol.

Contact: (see /about)