Coverage and cinema search

Search supported UK cinemas and understand how provider coverage is reported.

Use GET /v1/cinemas?search=Liverpool to match cinema names, localities, and postcodes. chainId can narrow any search.

For proximity search, provide either:

• postcode and radiusKm; or
• latitude, longitude, and radiusKm.

search, postcode, and coordinates are mutually exclusive. Radius searches are capped at 100 km.

CinemaData discovers venues independently from schedules. A cinema can therefore remain discoverable when it has no current screenings. An empty schedule is accepted only when the provider exposes an explicit empty state; missing or broken markup is treated as a failed collection and the previous valid snapshot is retained.

Provider coverage is activated only after source-use review, recorded conformance tests, and anomaly checks pass. Coverage documentation never treats a blocked provider or an unreviewed source as live data.

Screens

Use GET /v1/screens?cinemaId=... to list screens with stable provider identities that CinemaData has observed at a cinema. A showtime includes screenId when its provider exposes a stable screen identity and continues to include the provider’s original screenName label when available.

inventoryEvidence: "schedule_observed" means the screen was observed in a current schedule. It does not mean the result is a complete physical-screen inventory for that cinema or provider. CinemaData reports authoritative_inventory only when a provider supplies a separately verified, complete inventory; schedule labels alone never create screen identities.