API des séances de cinéma en France

Les cinémas français publient leur programme de mille façons : sites de billetterie des réseaux, widgets de réservation, simples pages web, parfois un PDF imprimé tous les quinze jours. API Cinéma les lit tous et renvoie un seul format JSON, le même pour un multiplexe de 20 salles et pour une salle de village.

Ce guide montre comment récupérer les séances en France : par ville, autour d’un point, par film et par cinéma.

Ce que couvre l’API en France

• Environ 2 000 cinémas : les multiplexes Pathé, UGC, CGR, Kinepolis et Mégarama, et les salles indépendantes et art et essai, partout en France métropolitaine.
• Chaque séance avec son heure locale, sa version (VF, VO, VOST), son format, la salle quand le cinéma la publie, et le lien de réservation.
• Chaque film avec un titre propre, son titre original, sa durée, son synopsis, ses genres et son affiche, rapproché de TMDB (tmdbId) pour reconnaître le même film d’un cinéma à l’autre.
• Chaque cinéma avec son adresse, ses coordonnées, son fuseau horaire, son nombre d’écrans et de fauteuils, et son identifiant CNC.

Chaque cinéma est relu tous les un à trois jours, et tous le sont chaque mercredi, jour des sorties.

1Obtenir une clé d’API

Créez un compte gratuit, confirmez votre adresse e-mail, puis créez une clé depuis le tableau de bord. L’offre gratuite donne 150 requêtes par semaine pour les tests et les projets non commerciaux ; les offres payantes commencent à 12 € par mois pour 10 000 par semaine.

Chaque requête porte la clé dans l’en-tête Authorization :

curl "https://api.api-cinema.com/v1/cinemas?city=Lyon" -H "Authorization: Bearer ac_live_…"

Gardez la clé côté serveur : jamais dans une application mobile ni dans du JavaScript exécuté par le navigateur.

2Les séances d’une ville

GET /v1/showtimes cherche parmi toutes les séances. Sans date, la recherche part de maintenant, à l’heure locale de chaque cinéma :

curl "https://api.api-cinema.com/v1/showtimes?country=FR&city=Lyon&limit=100" -H "Authorization: Bearer ac_live_…"

Chaque élément embarque le film et le cinéma :

{
  "id": "st_c9a6a699c415834b464de9ee",
  "startsAt": "2026-10-22T13:15:00",
  "version": "VF",
  "format": "2D",
  "room": "Salle 35",
  "bookingUrl": "https://www.ugc.fr/reservationSeances.html?id=330750313940",
  "movie": { "title": "Resident Evil", "durationMin": 94, "tmdbId": 1423191, "posterUrl": "…" },
  "cinema": { "name": "Ugc Cine Cite Part-Dieu", "city": "Lyon", "lat": 45.761001, "lng": 4.854442 }
}

startsAt est une heure « murale » dans le fuseau du cinéma, sans décalage : affichez-la telle quelle.

Filtres utiles :

city compare exactement le nom de la commune : city=Paris couvre tous les arrondissements (chacun marche aussi seul, city=Paris 5e Arrondissement), mais aucune ville n’inclut sa banlieue, donc Paris exclut Boulogne-Billancourt ou Montreuil. Pour toute une zone, cherchez autour d’un point.

3Autour d’un point

near prend une latitude et une longitude, radius_km un rayon (10 km par défaut). Tous les cinémas à moins de 3 km du Châtelet, à Paris :

curl "https://api.api-cinema.com/v1/cinemas?country=FR&near=48.8584,2.3470&radius_km=3" -H "Authorization: Bearer ac_live_…"

Les cinémas arrivent du plus proche au plus lointain, chacun avec sa distance distanceKm. Les mêmes paramètres marchent sur /v1/showtimes, pour « qu’est-ce qui passe près de moi ce soir » :

const res = await fetch('https://api.api-cinema.com/v1/showtimes/search', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${process.env.API_CINEMA_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    near: { lat: 48.8584, lng: 2.3470, radiusKm: 2 },
    version: 'VOST',
    limit: 50,
  }),
})
const { data } = await res.json()
for (const s of data)
  console.log(s.startsAt.slice(11, 16), s.movie.title, '—', s.cinema.name)

4Toutes les séances d’un film

Passez l’identifiant TMDB du film, ou son identifiant Allociné : le nombre dans l’URL de la fiche du film sur allocine.fr. Inutile de connaître nos propres identifiants, et vous obtenez le film dans tous les cinémas, quel que soit le titre publié par chacun :

curl "https://api.api-cinema.com/v1/showtimes?country=FR&tmdb_id=1368337&limit=100" -H "Authorization: Bearer ac_live_…"
curl "https://api.api-cinema.com/v1/showtimes?country=FR&allocine_id=1000013045&limit=100" -H "Authorization: Bearer ac_live_…"

Pour la liste des films à l’affiche en France : GET /v1/movies?country=FR&playing=true.

5Le programme d’un cinéma

Trouvez le cinéma par son nom, puis lisez ses séances. Le chemin accepte l’id du cinéma ou son slug :

curl "https://api.api-cinema.com/v1/cinemas?q=champo" -H "Authorization: Bearer ac_live_…"
curl "https://api.api-cinema.com/v1/cinemas/le-champo-paris-5e-arrondissement/showtimes" -H "Authorization: Bearer ac_live_…"

Sans date, la réponse donne le programme du jour ; ajoutez from et to pour la semaine.

6Gros volumes

• Les listes sont paginées : limit (jusqu’à 1 000 pour les séances) et offset, ou cursor pour parcourir tout un résultat dans un ordre stable.
• Pour tenir une copie locale à jour, appelez /v1/showtimes?updated_since=… avec l’heure de votre dernière synchronisation : vous ne recevez que ce qui a été ajouté, modifié ou retiré.
• Lisez l’en-tête X-RateLimit-Remaining et attendez Retry-After quand vous recevez un 429.

La documentation détaille chacun de ces points, avec tous les paramètres et tous les champs.

Questions fréquentes

Existe-t-il une API Allociné officielle ? Allociné ne propose plus d’API publique. API Cinéma est indépendante : elle lit les sources des cinémas eux-mêmes, et accepte les identifiants de films Allociné comme filtre pour faciliter le rapprochement avec des données existantes : voir passer de l’API Allociné à API Cinéma.

Quels cinémas sont inclus ? Presque tous les cinémas de France qui publient leur programme en ligne, réseaux comme indépendants (le guide Pathé et UGC détaille les deux grands réseaux). Cherchez-les avec GET /v1/cinemas?country=FR&q=<nom>.

Puis-je afficher les données dans mon application ou mon site ? Oui, c’est fait pour ça. Les conditions d’utilisation demandent un compte par client, la clé gardée côté serveur, et pas de revente des données brutes.