API Films Cinéma

Tous les films sortis en salles en France, semaine par semaine

← Retour à la navigation

Cette base de données recense les films sortis en salles en France, classés par date de sortie (mercredi). Les données sont accessibles via des fichiers JSON statiques.

Structure des données

data/
  {année}/
    index.json              # Liste des mercredis de l'année
    {YYYY-MM-DD}.json       # Films sortis ce mercredi
    images/                 # Affiches des films

Années disponibles : 2000 à 2026

Endpoints

Liste des sorties d'une année

GET /data/{année}/index.json

Retourne la liste de tous les mercredis de sortie pour une année donnée.

Exemple : /data/2024/index.json

[
  { "date": "2024-01-03", "resource_url": "2024-01-03.json" },
  { "date": "2024-01-10", "resource_url": "2024-01-10.json" },
  { "date": "2024-01-17", "resource_url": "2024-01-17.json" },
  ...
]
ChampTypeDescription
datestringDate au format YYYY-MM-DD
resource_urlstringNom du fichier JSON contenant les films

Films d'une semaine

GET /data/{année}/{YYYY-MM-DD}.json

Retourne la liste des films sortis un mercredi donné.

Exemple : /data/2024/2024-01-03.json

[
  {
    "release_date": "2024-01-03",
    "title": "Moi, capitaine",
    "director": "Matteo Garrone",
    "image_path": "images/2024-01-03_moi_capitaine.jpeg"
  },
  {
    "release_date": "2024-01-03",
    "title": "Priscilla",
    "director": "Sofia Coppola",
    "image_path": "images/2024-01-03_priscilla.jpg"
  },
  ...
]
ChampTypeDescription
release_datestringDate de sortie (YYYY-MM-DD)
titlestringTitre du film
directorstring?Réalisateur(s) — optionnel
image_pathstring?Chemin relatif vers l'affiche — optionnel

Affiche d'un film

GET /data/{année}/{image_path}

Récupère l'affiche d'un film. Le chemin est fourni dans le champ image_path.

Exemple : /data/2024/images/2024-01-03_moi_capitaine.jpeg

Note : Le champ image_path est optionnel. Certains films n'ont pas d'affiche disponible.

Exemples d'utilisation

JavaScript (fetch)

// Récupérer les sorties de 2024
const index = await fetch('/data/2024/index.json').then(r => r.json())

// Récupérer les films du premier mercredi
const films = await fetch(`/data/2024/${index[0].resource_url}`).then(r => r.json())

// Afficher les titres
films.forEach(film => console.log(film.title))

Filtrer par mois

// Films sortis en mars 2024
const index = await fetch('/data/2024/index.json').then(r => r.json())

const marchDates = index.filter(entry => entry.date.startsWith('2024-03'))

for (const entry of marchDates) {
  const films = await fetch(`/data/2024/${entry.resource_url}`).then(r => r.json())
  console.log(`${entry.date}: ${films.length} films`)
}

curl

# Liste des mercredis 2024
curl https://votre-domaine.com/data/2024/index.json

# Films du 3 janvier 2024
curl https://votre-domaine.com/data/2024/2024-01-03.json

Informations techniques