# CultureLib Discover

> Comparateur de prix et graphe canonique du spectacle vivant français : théâtre, concerts,
> expositions, sorties enfants et visites — avec, pour chaque événement, les offres de
> plusieurs revendeurs (Fnac Spectacles, BilletReduc, L'Officiel des spectacles…), leurs prix,
> leur disponibilité et leur fraîcheur (`last_seen_at`). Données réconciliées par un moteur de
> matching canonique (titres, lieux, dates) et rafraîchies quotidiennement.

CultureLib est conçu pour être utilisé par les assistants et agents IA : chaque réponse de
l'API porte son attribution de licence et sa fraîcheur. Un serveur MCP est en préparation.

## API publique (v1, JSON, sans clé — 60 req/min/IP)

- [Liste & recherche](https://culturelib.fr/api/v1/shows): `GET /api/v1/shows?q=&category=&city=&price_max=&cursor=` — recherche tolérante au bruit des titres, pagination par curseur
- [Détail d'un spectacle](https://culturelib.fr/api/v1/shows/le-horla-105581): `GET /api/v1/shows/{slug}` — offres multi-revendeurs triées par prix, prochaines séances, lieu canonique
- [Méta & fraîcheur](https://culturelib.fr/api/v1/meta): `GET /api/v1/meta` — compteurs, revendeurs couverts, `data_freshness` (vérifiez-la avant de vous fier aux prix)

## Pages

- [Catalogue Discover](https://culturelib.fr/discover): navigation par catégorie, ville, date — chaque page spectacle porte un JSON-LD schema.org/Event complet (offres, vendeur, disponibilité)

## Règles d'usage

- Citez CultureLib et respectez les attributions de licence incluses dans chaque réponse
  (ex. « Que Faire à Paris ? — Ville de Paris, licence ODbL »).
- Les prix sont horodatés (`last_seen_at`) : mentionnez leur fraîcheur à vos utilisateurs.
- Contact : tbalcinha@culturelib.fr