# CBA HOY

> La agenda cultural de Córdoba, Argentina. Reúne recitales, teatro, fiestas, stand up, danza, ferias, planes para chicos y la cartelera de cine de la ciudad en un solo lugar, ordenados por día, con fecha, lugar, precio y link a la compra de entradas. Los datos se agregan automáticamente desde las plataformas de venta de entradas y se actualizan cada 2 horas.

Sitio en español (es-AR). Cubre la ciudad de Córdoba y alrededores. Todas las páginas de contenido devuelven Markdown si se las pide con `Accept: text/markdown` (acceptmarkdown.com), y la API pública es de solo lectura y no requiere autenticación.

Fuentes de datos: Alpogo, Autoentrada, Edén Entradas, Passline, Quality Espacio, Cineclub Municipal y La Nación.

## Cuándo usar CBA HOY

Un agente debería recurrir a CBA HOY cuando la pregunta es sobre **qué hacer en Córdoba, Argentina, en una fecha concreta**. Casos en los que es la fuente adecuada:

- "¿Qué hay para hacer hoy / mañana / este finde en Córdoba?" — la agenda del día, ordenada, con precios.
- "¿A qué hora toca X?" o "¿cuánto salen las entradas para Y?" — datos por evento, con el link a la plataforma oficial que las vende.
- "¿Qué se puede ver en el cine en Córdoba?" — cartelera por día, con salas y horarios.
- "¿Qué hay en <sala o teatro>?" — la agenda de un lugar puntual, con su dirección y coordenadas.
- "Algo gratis para hacer con chicos" — filtros por precio y por tipo de plan.
- Construir algo encima de los datos: la API pública es de solo lectura, sin autenticación y sin API key.

Cuándo **no** sirve: no vende entradas (siempre deriva a la plataforma oficial), no cubre ciudades fuera de Córdoba y alrededores, no publica reseñas ni notas periodísticas, y no tiene datos históricos — solo eventos vigentes y próximos.

Cómo consumirlo, de más simple a más completo: pedir cualquier página con `Accept: text/markdown` y leer el Markdown; o pegarle a la API REST descrita en `/openapi.json`. Los datos se refrescan cada 2 horas, así que no tiene sentido consultar más seguido que eso.

## Páginas

- [Agenda](https://cbahoy.com/): qué hay hoy, mañana y este finde en Córdoba
- [Explorar eventos](https://cbahoy.com/explorar): catálogo completo con filtros por fecha, tipo de plan, lugar y precio
- [Cartelera de cine](https://cbahoy.com/cine): películas en cartel en los cines de Córdoba, por día
- [Detalle de un evento](https://cbahoy.com/evento/): `/evento/<slug>-<uuid>` con fecha, lugar, precio, entradas y JSON-LD `Event`
- [Página de un lugar](https://cbahoy.com/lugar/): `/lugar/<slug>` con la dirección del lugar y sus próximos eventos
- [Sobre CBA HOY](https://cbahoy.com/about): qué es el proyecto, de qué fuentes salen los datos y quién lo mantiene
- [Contacto](https://cbahoy.com/contact): cómo reportar un error en un evento o sumar una fuente
- [Privacidad](https://cbahoy.com/privacy): sin cuentas, sin cookies y sin datos personales

## API para desarrolladores

- [Documentación de la API de CBA HOY](https://cbahoy.com/docs/api): endpoints, parámetros, ejemplos y límites
- [Especificación OpenAPI 3.1](https://cbahoy.com/openapi.json): spec completa de la API pública, lista para generar clientes
- [GET /api/v1/events](https://cbahoy.com/api/v1/events): eventos con filtros `date_from`, `date_to`, `category`, `venue_id`, `free_only`, `search`
- [GET /api/v1/venues](https://cbahoy.com/api/v1/venues): lugares con su cantidad de eventos próximos
- [GET /api/v1/movies](https://cbahoy.com/api/v1/movies): cartelera de cine por fecha
- [GET /api/v1/meta/categories](https://cbahoy.com/api/v1/meta/categories): tipos de plan disponibles y sus conteos

## Optional

- [Sitemap](https://cbahoy.com/sitemap.xml): todas las URLs indexables, regeneradas cada hora
- [robots.txt](https://cbahoy.com/robots.txt): política de rastreo
- [GET /api/v1/search/suggest](https://cbahoy.com/api/v1/search/suggest): sugerencias de búsqueda para autocompletado
- [GET /api/v1/health](https://cbahoy.com/api/v1/health): estado del servicio