API Index (v1)
|Quick start guide
|The absolute basics you need to know to start getting data in just a few minutes.
|Headers and Responses
|Introductory documentation, providing an overview of how to setup your API requests, and handle responses.
|Frequently Asked Questions
|A selection of some of the questions we get asked about the most.
Then you need the details of each of our APIs below.
|Returns the top N films now showing, ordered by number of showtimes in database.
|Displays a list of films coming soon (sorted by popularity)
|Returns film titles matching search string – useful for search as you type or standard search. List is ordered by popularity using a count of number of showtimes in database.
|Return the nearest cinemas matching a cinema name query, for example Showcase. Works best with geolocation (Optional) within 75 miles. Also works with query only, sorting alphabetically. Can be used in a Search As You Type feature.
|Returns the metadata for a single specific film, including title, synopsis, cast, etc
|Returns the metadata for a single specific cinema, including name, address, logo
|Return the nearest cinemas based on a specific geolocation.
|Returns showtimes based on combination of cinema, date and film. Results can be sorted by popularity or alphabetically.
|Returns film showtimes based on combination of film, geolocation and date within 75 miles. Results are sorted by distance.
|For a given film and location, return the nearest cinema showing the film, regardless of time and date.
|Returns a URL deep link that links directly to cinema websites, with film, time and date selected.
|Returns URL’s for the images for a single specific film.
|Returns URL’s for the trailers for a single specific film.