API Cinéma

Alternative à l’API Fandango pour les séances aux États-Unis

Fandango n’ouvre pas d’API aux développeurs. Comment récupérer en JSON les séances d’environ 3 000 cinémas américains, AMC, Regal, Cinemark et indépendants, avec liens de réservation.

3 min de lecture

Sur cette page
  1. Ce que vous obtenez
  2. 1.Obtenir une clé
  3. 2.Les cinémas autour d’un point
  4. 3.Le programme d’un cinéma
  5. 4.Toutes les séances d’un film
  6. 5.IMAX et formats premium
  7. 6.Synchroniser dans votre base
  8. Questions fréquentes

Fandango vend les places de la plupart des cinémas américains, et les développeurs cherchent souvent une API Fandango pour récupérer les séances. Il n’en existe pas d’ouverte en libre-service : l’accès aux données de Fandango est réservé à ses partenaires commerciaux.

API Cinéma est une alternative indépendante, sans lien avec Fandango : les séances d’environ 3 000 cinémas américains en JSON, avec une clé que vous créez vous-même. Ce guide couvre les besoins courants : les cinémas autour d’un point, le programme d’un cinéma, toutes les séances d’un film.

Ce que vous obtenez

  • Environ 3 000 cinémas américains dans tous les États : AMC, Regal, Cinemark, Marcus, Harkins, Alamo Drafthouse, Landmark et de nombreux indépendants.
  • Chaque séance avec son heure locale, son format (2D, 3D, IMAX, 4DX, DOLBY) et un lien de réservation.
  • Chaque film avec titre, durée, synopsis, genres et affiche, rapproché de TMDB (tmdbId).
  • Chaque cinéma avec son adresse, son État, son code postal (ZIP), ses coordonnées et son fuseau horaire.

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 pour 10 000 requêtes par semaine.

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

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

Les cinémas autour d’un point

La plupart des applications partent de la position de l’utilisateur. Passez une latitude et une longitude à near, et un rayon en kilomètres à radius_km (10 par défaut) :

Terminal
curl "https://api.api-cinema.com/v1/cinemas?country=US&near=41.8781,-87.6298&radius_km=16" -H "Authorization: Bearer ac_live_…"
JSON
{
  "data": [
    { "slug": "amc-river-east-21-chicago-il", "name": "AMC River East 21", "city": "Chicago", "region": "IL", "postalCode": "60611", "timezone": "America/Chicago", "distanceKm": 1.65 }
  ],
  "meta": { "limit": 50, "offset": 0, "total": 22 }
}

Pour partir d’un code postal (ZIP), géocodez-le d’abord avec le service de votre choix, puis cherchez autour de ce point.

Le programme d’un cinéma

Terminal
curl "https://api.api-cinema.com/v1/cinemas/amc-empire-25-new-york-ny/showtimes?include=movie" -H "Authorization: Bearer ac_live_…"

Sans date, vous obtenez la journée ; ajoutez from et to pour les jours suivants. startsAt est l’heure locale du cinéma : 19:30 à Chicago signifie 19 h 30 à Chicago, quel que soit le fuseau de votre serveur.

Toutes les séances d’un film

Filtrez par identifiant TMDB pour obtenir un film dans tous les cinémas, quel que soit le titre publié par chacun :

Terminal
curl "https://api.api-cinema.com/v1/showtimes?country=US&tmdb_id=1368337&near=34.0522,-118.2437&radius_km=25" -H "Authorization: Bearer ac_live_…"

Les films à l’affiche aux États-Unis : GET /v1/movies?country=US&playing=true.

IMAX et formats premium

Le format figure dans chaque séance. Les séances IMAX et Dolby de ce soir à moins de 10 km du centre de Los Angeles :

JavaScript
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({
    country: 'US',
    near: { lat: 34.0522, lng: -118.2437, radiusKm: 10 },
    from: '2026-10-28T17:00',
    to: '2026-10-28T23:59',
    limit: 1000,
  }),
})
const { data } = await res.json()
for (const s of data.filter(s => s.format === 'IMAX' || s.format === 'DOLBY'))
  console.log(s.startsAt.slice(11, 16), s.format, s.movie.title, '—', s.cinema.name)

Synchroniser dans votre base

Passez l’heure de votre dernière synchronisation à updated_since : vous ne recevez que les séances ajoutées, modifiées ou retirées depuis. Le guide États-Unis et la documentation détaillent la pagination et les limites de débit.

Questions fréquentes

API Cinéma est-elle liée à Fandango ? Non. API Cinéma est un service indépendant, sans lien avec Fandango ni avec les réseaux de cinémas.

Peut-on vendre des places via l’API ? Non : l’API donne les séances et un lien de réservation par séance. La billetterie reste sur la page du cinéma ou du site de billetterie.

Les prix, le placement ou les notes sont-ils inclus ? Non : cinémas, films et séances uniquement.

Et le Canada ? Pas encore : les États-Unis et la France sont couverts aujourd’hui.