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

Base URL for all queries:

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

Fields

Search by City or Name

Use the search() function for full-text matching on a specific field.

GET /api/explore/v2.1/catalog/datasets/etablissements-cinematographiques/records?where=search(commune,"Marseille")&limit=20

Combine with other filters using AND:

?where=search(commune,"Paris") AND ecrans>=5

Search by cinema name:

?where=search(nom,"Pathe")

Search by Region or Department

Region values are uppercase. Common values: ILE DE FRANCE, AUVERGNE-RHONE-ALPES, PROVENCE-ALPES-COTE D'AZUR, OCCITANIE, NOUVELLE-AQUITAINE, HAUTS-DE-FRANCE, GRAND EST, PAYS DE LA LOIRE, BRETAGNE, NORMANDIE, BOURGOGNE-FRANCHE-COMTE, CENTRE-VAL DE LOIRE, CORSE, OUTRE-MER.

?where=region_administrative="BRETAGNE"&limit=50

By department number:

?where=dep="75"

Geographic Proximity Search

Find cinemas within a radius of a point. Coordinates use longitude first, then latitude (POINT(lon lat)).

?where=within_distance(geolocalisation, geom'POINT(2.3522 48.8566)', 5km)

This returns cinemas within 5 km of central Paris. Supported units: m, km, mi, yd, ft.

Combine with other filters:

?where=within_distance(geolocalisation, geom'POINT(2.3522 48.8566)', 10km) AND ae="AE"

Filter by Type

Art et Essai cinemas (independent/arthouse):

?where=ae="AE"

Multiplexes (8+ screens):

?where=multiplexe="OUI"

Fixed venues only (excludes itinerant and seasonal):

?where=genre="Fixe"

Sorting and Pagination

Sort by any numeric field. Use desc for descending.

?order_by=entrees_2022 desc&limit=10

Paginate with offset:

?limit=20&offset=40

Maximum limit is 100 per request. Use offset to iterate through all results.

Selecting Fields

Return only specific fields to reduce response size:

?select=nom,commune,ecrans,fauteuils,entrees_2022&limit=10

Aggregation

Group and aggregate data:

?select=region_administrative,count(*) as total,sum(ecrans) as total_screens&group_by=region_administrative&order_by=total desc

Combining Filters

Build complex queries with AND/OR:

?where=region_administrative="BRETAGNE" AND ecrans>=3 AND ae="AE"&order_by=entrees_2022 desc

Large cinemas (10+ screens) in a city:

?where=search(commune,"Lyon") AND ecrans>=10&select=nom,commune,ecrans,fauteuils

Response Format

The API returns JSON. Each response has:

{
  "total_count": 42,
  "results": [
    {
      "nom": "CINEMA EXAMPLE",
      "commune": "PARIS",
      "ecrans": 12,
      "fauteuils": 2800,
      "entrees_2022": 450000,
      "geolocalisation": { "lat": 48.856, "lon": 2.352 },
      ...
    }
  ]
}

total_count gives the total matching records (useful for pagination). results contains the matching cinema records.

Common Recipes

Find the biggest cinema in France:

?order_by=fauteuils desc&limit=1&select=nom,commune,ecrans,fauteuils,entrees_2022

All Art et Essai cinemas in Paris:

?where=dep="75" AND ae="AE"&order_by=nom asc

Cinemas near a user's location (replace coordinates):

?where=within_distance(geolocalisation, geom'POINT(USER_LON USER_LAT)', 15km)&order_by=entrees_2022 desc&limit=10

Rural cinemas with high attendance:

?where=zone_de_la_commune="R" AND entrees_2022>50000&order_by=entrees_2022 desc

Summary statistics by region:

?select=region_administrative,count(*) as cinemas,sum(ecrans) as screens,sum(fauteuils) as seats&group_by=region_administrative&order_by=cinemas desc

Troubleshooting

No results returned

Check that text values are uppercase. Region and city names in this dataset use uppercase (e.g., "LYON" not "Lyon"). The search() function is case-insensitive, but exact equality checks are not.

Invalid query syntax

ODSQL uses double quotes for string values in where clauses. Single quotes are only used for geometry literals (geom'POINT(...)').

Pagination limit

The API returns at most 100 records per request. To retrieve all matching records, loop with offset increments of your limit value until results is empty.