API Cinéma

API Allociné : une alternative pour les séances de cinéma

Allociné n’ouvre plus d’API publique. Comment récupérer à la place les séances des cinémas français en JSON, en gardant les identifiants de films Allociné pour vos données existantes.

3 min de lecture

Sur cette page
  1. Ce que vous obtenez
  2. 1.Obtenir une clé
  3. 2.Des appels Allociné à API Cinéma
  4. 3.Garder vos identifiants Allociné
  5. 4.La semaine d’un cinéma
  6. 5.Tenir une copie locale à jour
  7. Questions fréquentes

Pendant des années, Allociné a été la source des développeurs français pour les données cinéma : films, salles et séances derrière une seule API. Cette API n’est plus ouverte au public, et les clés qui traînent encore dans de vieux tutoriels ou des projets GitHub ne sont pas destinées aux applications tierces.

API Cinéma est une alternative indépendante, sans lien avec Allociné : les séances des cinémas français en JSON, avec une clé d’API que vous créez vous-même en une minute. Ce guide montre comment remplacer les appels Allociné habituels, et comment garder les identifiants de films Allociné sur lesquels vos données reposent peut-être déjà.

Ce que vous obtenez

  • Environ 2 000 cinémas en France, des multiplexes Pathé, UGC, CGR, Kinepolis et Mégarama aux salles indépendantes et art et essai.
  • Chaque séance avec son heure locale, sa version (VF, VO, VOST), son format (2D, 3D, IMAX, 4DX, DOLBY), la salle quand le cinéma la publie, et un lien de réservation.
  • Chaque film avec son titre, son titre original, sa durée, son synopsis, ses genres et son affiche, rapproché de TMDB, et avec son identifiant Allociné (allocineId) quand il est connu.
  • Chaque cinéma avec son adresse, ses coordonnées et son numéro CNC, l’identifiant national qui ne change jamais.

Les données sont rafraîchies tous les un à trois jours, et chaque cinéma est relu le mercredi, jour des sorties.

Obtenir une clé

Créez un compte gratuit et 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.

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

La clé va dans l’en-tête Authorization, depuis votre serveur uniquement.

Des appels Allociné à API Cinéma

Les besoins courants tiennent en quelques routes :

Vous demandiez à Allociné… Avec API Cinéma
les cinémas d’une ville GET /v1/cinemas?country=FR&city=Nantes
les cinémas autour d’un point GET /v1/cinemas?country=FR&near=48.8584,2.3470&radius_km=5
le programme d’un cinéma GET /v1/cinemas/{id ou slug}/showtimes
les films à l’affiche GET /v1/movies?country=FR&playing=true
toutes les séances d’un film GET /v1/showtimes?country=FR&allocine_id=…
la fiche d’un film GET /v1/movies/{id}

Chaque liste répond avec data et un bloc meta pour la pagination (limit, offset, total).

Garder vos identifiants Allociné

Si votre base stocke des identifiants de films Allociné, inutile de tout remapper. Passez l’identifiant, le nombre dans l’URL de la fiche du film sur allocine.fr (fichefilm_gen_cfilm=1000013045), à allocine_id :

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

Vous obtenez les séances du film dans tous les cinémas, y compris ceux qui le publient sous un autre titre, dès que le film est rapproché de TMDB. Chaque film des réponses porte les deux identifiants, allocineId et tmdbId, pour passer aux identifiants TMDB à votre rythme :

JSON
{
  "id": "065ec55d-531e-486a-9cff-ce8c2f4de87c",
  "title": "L'Odyssée",
  "originalTitle": "The Odyssey",
  "durationMin": 172,
  "allocineId": "1000013045",
  "tmdbId": 1368337
}

La semaine d’un cinéma

Cherchez le cinéma par son nom, puis demandez ses séances sur une période :

Terminal
curl "https://api.api-cinema.com/v1/cinemas?country=FR&q=champo" -H "Authorization: Bearer ac_live_…"
curl "https://api.api-cinema.com/v1/cinemas/le-champo-paris-5e-arrondissement/showtimes?from=2026-10-28&to=2026-11-03" -H "Authorization: Bearer ac_live_…"

Les heures (startsAt) sont des heures locales du cinéma, sans décalage : affichez-les telles quelles. Le guide France détaille les autres filtres (version, plage horaire, autour d’un point).

Tenir une copie locale à jour

Beaucoup d’intégrations Allociné recopiaient le programme dans leur propre base chaque nuit. Faites de même avec updated_since : passez l’heure de votre dernière synchronisation et vous ne recevez que les séances ajoutées, modifiées ou retirées depuis (removedAt est renseigné sur les séances retirées).

Terminal
curl "https://api.api-cinema.com/v1/showtimes?country=FR&updated_since=2026-10-27T03:00:00Z&limit=1000" -H "Authorization: Bearer ac_live_…"

Questions fréquentes

API Cinéma est-elle liée à Allociné ? Non. API Cinéma est un service indépendant ; les identifiants de films Allociné sont acceptés comme filtre uniquement pour rapprocher les données existantes.

Les mêmes cinémas sont-ils couverts ? Presque tous les cinémas français qui publient leur programme en ligne, réseaux comme indépendants. Cherchez-en un avec GET /v1/cinemas?country=FR&q=<nom>.

Les notes presse et spectateurs sont-elles incluses ? Non : l’API porte sur les cinémas, les films et les séances. Notes, critiques et bandes-annonces n’en font pas partie.

Puis-je l’utiliser dans une application commerciale ? Oui, avec une offre payante. Les conditions d’utilisation demandent de garder la clé côté serveur et interdisent la revente des données brutes.