Le goût du temps,
mis en données
Une API RESTful qui unifie les opinions culturelles du moment, les lie aux œuvres, et expose catalogue, événements et lieux via une interface géospatiale unifiée.
Catalogue d'œuvres
Films, pièces, expositions, concerts, livres — enrichis via TMDB, MusicBrainz, Wikidata. Embeddings vectoriels pour la similarité sémantique.
Événements géolocalisés
Séances, concerts, expositions dans 81 135 lieux culturels. Recherche par rayon géographique, dates et type d'événement.
Opinions de critiques
Agrégées depuis des sources éditoriales de référence. Sentiment, résumé et citations clés par œuvre.
Verticales
celyn Culture API
Disponible · Bêta gratuiteŒuvres, événements, lieux, recommandations. Testable dans le sandbox, accessible en self-service.
Créer un comptecelyn Sport
En production · Accès sur demandeActualité football en temps réel (transferts, résultats, compos). Accès activé à la demande sur votre clé (scope actu).
celyn Actu
En production · Accès sur demandeActualité générale consolidée et vérifiée par recoupement de sources. Accès activé à la demande sur votre clé (scope actu).
{
"data": [
{
"oeuvreId": "b2a4c6e8-1357-4bdf-a024-68ace02468bd",
"id": "b2a4c6e8-1357-4bdf-a024-68ace02468bd",
"title": "Titre d'exemple",
"oeuvreType": "film",
"director": "Nom Réalisateur",
"author": null,
"year": 2025,
"imageUrl": null,
"score": 0.82,
"explanation": "très similaire thématiquement, bien noté par les critiques",
"signals": {
"embeddingSimilarity": 0.91,
"curatorWeight": 0.75,
"temporalDecay": 0.6,
"geoProximity": 0.4,
"topicalityBoost": 0.55
},
"opinions": [
{
"criticName": "Nom Critique",
"opinionSummary": "Résumé d'exemple.",
"sentiment": "very_positive",
"showName": "Émission d'exemple",
"publishedAt": "2026-09-18T07:00:00.000Z"
}
],
"nearbyEvents": [
{
"venueId": "7b1e2d90-4a6c-4f0e-8c21-5d6e7f8a9b0c",
"venueName": "Cinéma Exemple",
"startTime": "2026-10-03T20:30:00.000Z",
"endTime": null,
"price": 9.5,
"distance_km": 2.1
}
]
}
],
"meta": {
"sourceOeuvreId": "b2a4c6e8-1357-4bdf-a024-68ace02468bd",
"weights": {
"embeddingSimilarity": 0.4,
"curatorWeight": 0.3,
"temporalDecay": 0.15,
"geoProximity": 0.15,
"topicalityBoost": 0.1
},
"candidateCount": 1,
"cachedAt": "2026-09-24T10:00:00.000Z"
}
}
Exemple de forme de réponse (valeurs fictives, structure identique à l'API réelle). Le score combine similarité sémantique, poids des critiques, fraîcheur, proximité et actualité : voir meta.weights.
Qui sommes-nous
celyn Culture API est développé à Paris par Julien Tassy. Données culturelles curées depuis un réseau de sources éditoriales.
Prêt à intégrer le goût du temps ?
Créez un compte développeur, générez une clé API et accédez à la documentation complète en quelques minutes.
Créer un compte →