API des séances de cinéma en Australie

En Australie, les séances de cinéma sont dispersées entre les sites des réseaux et leurs systèmes de billetterie, et aucun n’ouvre d’API. API Cinéma rassemble les séances des cinémas australiens dans une seule API JSON, au même format pour un multiplexe Hoyts de 20 salles et pour un Palace art et essai à deux écrans.

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

Ce que couvre l’API en Australie

• Environ 120 cinémas dans tous les États et territoires : Hoyts (environ 50), Event Cinemas (environ 50, Greater Union et BCC inclus) et Palace (environ 20). La couverture commence par ces trois réseaux et s’étend.
• Chaque séance avec son heure locale, son format (2D, 3D, IMAX, 4DX), sa version (VO, ou VOST pour les séances sous-titrées ou en open caption) et un lien de réservation vers la billetterie du réseau (hoyts.com.au, eventcinemas.com.au, buy.palacecinemas.com.au).
• 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 (region : NSW, VIC, QLD, SA, WA, ACT, TAS, NT), son code postal à 4 chiffres, ses coordonnées et son fuseau horaire.

Chaque cinéma est relu tous les jours.

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.

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

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

2Ciné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 5 km du centre de Sydney, du plus proche au plus lointain :

curl "https://api.api-cinema.com/v1/cinemas?country=AU&near=-33.8688,151.2093&radius_km=5" -H "Authorization: Bearer ac_live_…"

{
  "data": [
    { "id": "evt_15", "slug": "event-cinemas-george-street-sydney-nsw", "name": "Event Cinemas George Street", "address": "505-525 George Street", "city": "Sydney", "region": "NSW", "postalCode": "2000", "timezone": "Australia/Sydney", "distanceKm": 0.46 },
    { "id": "pal_200", "slug": "palace-central-cinema-sydney-chippendale-nsw", "name": "Palace Central Cinema Sydney", "address": "Central Park Mall", "city": "Chippendale", "region": "NSW", "timezone": "Australia/Sydney", "distanceKm": 1.52 }
  ],
  "meta": { "limit": 50, "offset": 0, "total": 6 }
}

Les mêmes paramètres sur /v1/showtimes répondent à « qu’est-ce qui passe près de moi ». Melbourne, 10 km autour du centre :

curl "https://api.api-cinema.com/v1/showtimes?country=AU&near=-37.8136,144.9631&radius_km=10&limit=200" -H "Authorization: Bearer ac_live_…"

Préférez near à city pour les grandes métropoles : city compare exactement le nom du quartier (suburb), donc « Sydney » exclut Bondi Junction et « Melbourne » exclut Coburg. city=Brisbane fonctionne quand le cinéma est rattaché à la ville elle-même.

3Fuseaux horaires

L’Australie compte cinq fuseaux, et chaque heure de l’API est l’heure locale du cinéma : "startsAt": "2026-11-06T19:30:00" dans un cinéma de Perth veut dire 19 h 30 à Perth. Affichez-la telle quelle. Le timezone du cinéma (Australia/Sydney, Australia/Brisbane, Australia/Adelaide, Australia/Darwin ou Australia/Perth) est là si vous devez la comparer à l’horloge de l’utilisateur, et il porte l’heure d’été : la Nouvelle-Galles du Sud, le Victoria, l’ACT, la Tasmanie et l’Australie-Méridionale changent d’heure d’octobre à avril, le Queensland, le Territoire du Nord et l’Australie-Occidentale non.

Les filtres de date suivent la même règle : date=2026-11-06 couvre tout le 6 novembre à l’heure locale de chaque cinéma, et sans date ni from la recherche part de « maintenant » dans le fuseau de chaque cinéma.

4Toutes les séances d’un film

Trouvez le film parmi ceux à l’affiche en Australie, puis filtrez par identifiant TMDB pour l’avoir dans tous les cinémas, quel que soit le titre publié par chaque réseau :

curl "https://api.api-cinema.com/v1/movies?q=odyssey&playing=true&country=AU" -H "Authorization: Bearer ac_live_…"
curl "https://api.api-cinema.com/v1/showtimes?country=AU&tmdb_id=1368337&near=-27.4698,153.0251&radius_km=15" -H "Authorization: Bearer ac_live_…"

Pour lister les films à l’affiche en Australie, utilisez GET /v1/movies?country=AU&playing=true.

5La semaine d’un cinéma

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

curl "https://api.api-cinema.com/v1/cinemas?country=AU&q=hoyts%20melbourne" -H "Authorization: Bearer ac_live_…"
curl "https://api.api-cinema.com/v1/cinemas/hoyts_mcecin/showtimes?from=2026-11-06&to=2026-11-12&include=movie" -H "Authorization: Bearer ac_live_…"

include=movie n’embarque que le film : le cinéma est le même sur chaque ligne, le laisser de côté allège la réponse.

6Codes postaux et États

zip_code garde les cinémas dont le code postal commence par les chiffres donnés : zip_code=2000 pour le centre de Sydney, zip_code=3 pour tout le Victoria. Le champ region contient le code de l’État, pratique pour regrouper une liste nationale par État :

curl "https://api.api-cinema.com/v1/cinemas?country=AU&zip_code=2000" -H "Authorization: Bearer ac_live_…"

7Un 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 Sydney :

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: 'AU',
    near: { lat: -33.8688, lng: 151.2093, radiusKm: 10 },
    from: '2026-11-06T18:00',
    to: '2026-11-06T23: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)

8Gros 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 par différence avec updated_since. La documentation détaille 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é.

Les données sont-elles à jour ? Chaque cinéma est relu tous les jours. Les séances retirées sont signalées (removedAt) dans les synchronisations incrémentales.

Quels réseaux sont couverts ? Hoyts, Event Cinemas (Greater Union et BCC inclus) et Palace. Cherchez un cinéma avec GET /v1/cinemas?country=AU&q=<nom> ; la couverture s’étend réseau par réseau.

Que veut dire version pour une séance australienne ? VO est la version originale, VOST une séance sous-titrée ou en open caption (un film en hindi sous-titré en anglais, une séance en open caption d’un film anglophone). UNKNOWN signale une séance doublée.

Puis-je l’utiliser dans une application commerciale ? L’offre gratuite est réservée aux tests et aux projets non commerciaux ; un site ou une application qui génère des revenus ou sert une entreprise nécessite une offre payante, à partir de 12 € par mois.