france-cinemas

# France Cinemas (No API key)

Search and explore the official French government dataset of cinema establishments. The dataset contains 2,061 cinemas with screen counts, seat capacity, attendance figures, Art et Essai classification, geographic coordinates, and more.

Data source: Ministere de la Culture, updated periodically. Licence Ouverte / Open Licence.

## Quick Reference

| Action | Endpoint |
|--------|----------|
| Search by city | `?where=search(commune,"Lyon")` |
| Search by name | `?where=search(nom,"Gaumont")` |
| Nearby cinemas | `?where=within_distance(geolocalisation,geom'POINT(lon lat)',10km)` |
| Art et Essai only | `?where=ae="AE"` |
| Multiplexes only | `?where=multiplexe="OUI"` |
| By region | `?where=region_administrative="ILE DE FRANCE"` |
| Top by attendance | `?order_by=entrees_2022 desc&limit=10` |

Base URL for all queries:

```
https://data.culture.gouv.fr/api/explore/v2.1/catalog/datasets/etablissements-cinematographiques/records
```

## Fields

| Field | Type | Description |
|-------|------|-------------|
| `nom` | text | Cinema name |
| `commune` | text | City name |
| `dep` | text | Department number (e.g. "75") |
| `region_administrative` | text | Region (e.g. "ILE DE FRANCE") |
| `adresse` | text | Street address |
| `code_insee` | text | INSEE municipality code |
| `population_commune` | int | City population |
| `ecrans` | int | Number of screens |
| `fauteuils` | int | Total seats |
| `entrees_2022` | int | Admissions in 2022 |
| `ae` | text | Art et Essai label ("AE" or empty) |
| `genre` | text | Venue type ("Fixe", "Itinerant", "Saisonnier") |
| `multiplexe` | text | Multiplex status ("OUI", "NON") |
| `zone_de_la_commune` | text | Urban zone ("U" urban, "R" rural) |
| `geolocalisation` | geo_point | Latitude/longitude coordinates |
| `nombre_de_films_programmes` | int | Number of films screened |
| `nombre_de_films_inedits` | int | Number of first-run films |
| `nombre_de_films_en_semaine_1` | int | Films in their first week...