Cinemas in France

Search French cinema establishments using the open data.culture.gouv.fr API. Query by city, region, proximity, screen count, Art et Essai label, and multiple...

Security Scan

The skill is an instruction-only connector for the public data.culture.gouv.fr dataset and its requirements and instructions are consistent with that purpose.

Purpose & Capability

The name and description claim access to the French governmental cinema dataset and the SKILL.md contains only query examples and field descriptions for that dataset. There are no unrelated requested binaries, environment variables, or install steps that would be disproportionate to the stated purpose.

Instruction Scope

The instructions are limited to constructing HTTP queries against the public API (data.culture.gouv.fr) and explain filters, pagination, selection and aggregation. The SKILL.md does not ask the agent to read local files, environment variables, or forward results to any third-party endpoint. Note: proximity examples use USER_LON/USER_LAT placeholders — using them would require the agent to obtain user location data, which is expected for proximity searches but is personal data when supplied.

Install Mechanism

No install spec and no code files are present; this is instruction-only so nothing is written to disk or downloaded during install.

Credentials

The skill declares no required environment variables, credentials, or config paths. That aligns with the SKILL.md statement that no API key is required for the public dataset.

Persistence & Privilege

always is false and the skill does not request persistent or elevated privileges nor does it instruct modifying other skills or system-wide agent settings.

Assessment

This skill appears coherent and limited to querying a public French government dataset; no credentials or installs are required. Before using, consider: (1) proximity queries require you to supply coordinates — treat those as personal data you may not want to share automatically; (2) the agent will make outbound network requests to data.culture.gouv.fr when invoked, so only enable the skill for agents you trust to perform those requests; (3) if you want to restrict autonomous behavior, keep model-invocation disabled for agents that should not call skills without your confirmation.

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
pdm_en_entrees	float	Market share by admissions

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.