Sur cette page
Aux États-Unis, les séances de cinéma sont dispersées entre les sites des réseaux et les plateformes de billetterie, et rares sont celles qui ouvrent une API. API Cinéma rassemble les séances des cinémas américains dans une seule API JSON, au même format pour un AMC de 25 salles et pour un cinéma indépendant à écran unique.
Ce guide montre comment récupérer les séances aux États-Unis : autour d’un point, par ville, par film et par cinéma.
Ce que couvre l’API aux États-Unis
- Plus de 3 000 cinémas dans tous les États : AMC (environ 500), Regal (environ 400), Cinemark (environ 300), Alamo Drafthouse et des cinémas indépendants.
- Chaque séance avec son heure locale, son format (
2D,3D,IMAX,DOLBY,4DX), sa version (VO, ouVOSTpour les séances sous-titrées) et un lien de réservation. - Chaque film avec un titre propre, sa durée, son synopsis, ses genres et son affiche, rapproché de TMDB (
tmdbId). - Chaque cinéma avec son adresse, son État, son code postal (ZIP), ses coordonnées et son fuseau horaire.
Chaque cinéma est relu tous les un à trois jours, et tous le sont une fois par semaine.
Obtenir 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.
Envoyez la clé dans l’en-tête Authorization, depuis votre serveur uniquement :
curl "https://api.api-cinema.com/v1/cinemas?country=US&city=Chicago" -H "Authorization: Bearer ac_live_…"Cinémas et séances autour d’un point
La plupart des applications partent de la position de l’utilisateur. near prend une latitude et une longitude, radius_km un rayon en kilomètres (10 par défaut). Les cinémas à moins de 3 km de Times Square, du plus proche au plus lointain :
curl "https://api.api-cinema.com/v1/cinemas?country=US&near=40.758,-73.9855&radius_km=3" -H "Authorization: Bearer ac_live_…"{
"data": [
{ "id": "fdg_aaore", "slug": "amc-empire-25-new-york-ny", "name": "AMC Empire 25", "address": "234 West 42nd St.", "city": "New York", "region": "NY", "timezone": "America/New_York", "distanceKm": 0.28 },
{ "id": "fdg_aaodh", "slug": "regal-times-square-new-york-ny", "name": "Regal Times Square", "address": "247 W. 42nd St.", "city": "New York", "region": "NY", "timezone": "America/New_York", "distanceKm": 0.32 }
],
"meta": { "limit": 50, "offset": 0, "total": 13 }
}Les mêmes paramètres sur /v1/showtimes répondent à « qu’est-ce qui passe près de moi » :
curl "https://api.api-cinema.com/v1/showtimes?country=US&near=40.758,-73.9855&radius_km=5&limit=200" -H "Authorization: Bearer ac_live_…"Préférez near à city pour les grandes agglomérations : city compare exactement le nom de la ville, donc « New York » exclut Brooklyn et « Los Angeles » exclut Burbank.
Les fuseaux horaires
Les États-Unis couvrent plusieurs fuseaux horaires, et chaque heure de l’API est l’heure locale du cinéma : "startsAt": "2026-10-24T19:30:00" dans un cinéma de Chicago signifie 19 h 30 à Chicago. Affichez-la telle quelle. Le fuseau du cinéma (timezone, par exemple America/Chicago) est là si vous devez comparer avec l’horloge de l’utilisateur.
Les filtres de date suivent la même règle : date=2026-10-24 couvre toute la journée du 24 octobre à l’heure locale de chaque cinéma, et sans date ni from la recherche part de « maintenant » dans le fuseau de chaque cinéma.
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 (« The Odyssey » ici, « Odyssey » là) :
curl "https://api.api-cinema.com/v1/showtimes?country=US&tmdb_id=1368337&near=34.0522,-118.2437&radius_km=15" -H "Authorization: Bearer ac_live_…"Pour la liste des films à l’affiche aux États-Unis : GET /v1/movies?country=US&playing=true.
Le 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?country=US&q=empire%2025" -H "Authorization: Bearer ac_live_…"
curl "https://api.api-cinema.com/v1/cinemas/amc-empire-25-new-york-ny/showtimes?include=movie" -H "Authorization: Bearer ac_live_…"include=movie n’embarque que le film : le cinéma est le même sur chaque ligne, l’omettre allège la réponse.
Un corps JSON pour les recherches complexes
Chaque recherche existe aussi en POST …/search avec un corps JSON, plus simple à construire depuis du code. Les séances IMAX de ce soir à moins de 10 km du centre de Chicago :
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: 41.8781, lng: -87.6298, radiusKm: 10 },
from: '2026-10-24T18:00',
to: '2026-10-24T23:59',
limit: 200,
}),
})
const { data } = await res.json()
for (const s of data.filter(s => s.format === 'IMAX'))
console.log(s.startsAt.slice(11, 16), s.movie.title, '—', s.cinema.name, s.bookingUrl)Gros volumes
Les listes sont paginées avec limit (jusqu’à 1 000 séances) et offset, ou cursor pour parcourir tout un résultat. Pour répliquer les données dans votre propre base, synchronisez de façon incrémentale avec updated_since. La documentation couvre les deux, ainsi que les limites de débit.
Questions fréquentes
Les prix des billets sont-ils inclus ? Non : l’API donne les séances et un lien de réservation par séance, où le prix est affiché.
Quelle est la fraîcheur des données ?
Chaque cinéma est relu tous les un à trois jours, plus souvent pour les plus fréquentés, et tous le sont chaque semaine. Les séances retirées sont signalées (removedAt) dans les synchronisations incrémentales.
Quels réseaux sont couverts ?
AMC, Regal, Cinemark, Alamo Drafthouse, Marcus, Harkins, Landmark et de nombreux indépendants. Cherchez un cinéma avec GET /v1/cinemas?country=US&q=<nom>.
Existe-t-il une API Fandango ? Fandango n’ouvre pas d’API aux développeurs ; voir l’alternative à l’API Fandango pour les appels équivalents.