bolster.data_sources.cineworld

Cineworld Cinema Listings Data Integration.

This module provides access to current cinema listings and film showtimes from Cineworld cinemas across the UK through their public API. The data includes film information, screening times, and cinema-specific details for planning cinema visits and entertainment analysis.

Data Source: Cineworld provides cinema listings through their public data API service at https://www.cineworld.co.uk/uk/data-api-service/. The API delivers real-time information about current films, screening times, and availability across all Cineworld cinema locations in the UK. The service provides structured JSON data suitable for automated processing and integration.

Update Frequency: Cinema listings are updated continuously throughout the day as new showtimes are scheduled and availability changes. The data reflects real-time cinema schedules with immediate updates for booking availability, screening times, and new film releases. Data is refreshed multiple times daily to maintain accuracy for current and upcoming showings.

Example

Retrieve current cinema listings for Belfast Cineworld:

>>> from bolster.data_sources import cineworld
>>> listings = cineworld.get_cinema_listings(117)
>>> len(listings) > 0
True
>>> 'name' in listings[0]
True

Site Code 117 maps to Belfast, you’re on your own for the rest.

Attributes

logger

Functions

get_cinema_listings([site_code, screening_date])

Get cinema listings from the Cineworld API.

Module Contents

bolster.data_sources.cineworld.logger[source]
bolster.data_sources.cineworld.get_cinema_listings(site_code=117, screening_date=None)[source]

Get cinema listings from the Cineworld API.

Parameters:

  • site_code (int) – The site code of the cinema. Defaults to 117; Belfast

  • screening_date (date) – The date for which to retrieve the listings. Defaults to today’s date.

Returns:

A dictionary containing the cinema listings.

Return type:

dict

Raises:

Exception – If there was an error making the API request.

>>> cinema_listings = get_cinema_listings(117)
>>> set(cinema_listings[0].keys()).issuperset({'id', 'name','link','weight','releaseYear','releaseDate','attributeIds','date','site_code'})
True
>>> list(cinema_listings[0].keys()) # This is likely to break from upstream changes
['id', 'name', 'length', 'posterLink', 'videoLink', 'link', 'weight', 'releaseYear', 'releaseDate', 'attributeIds', 'date', 'site_code']