To get started, we recommend you try out our APIs with Postman or a similar application.
Please note that our evaluation API uses UK data. Once you have evaluated it from a technical perspective, we would be pleased to discuss our coverage in other countries.
Get your Evaluation API Key
First of all, you will need to request an API key. You will then receive an email containing the access credentials required below.
We have created a set of sample Postman files for you to import – including Environment, Collection and Globals. All of our APIs are already set up for you – you just need to add in your access credentials, and you’re ready to go.
* Note – the final / is very important.
Required headers and values
You can find the required [values] for the Header fields below, in your email with subject: “Your MovieGlu API access credentials”.
- client: [Username]
- x-api-key: [API Key]
- Authorization: [Basic Authentication]
- api-version: v102
- Geolocation: lat;lng (Note the use of a semicolon. See documentation for further details)
Please refer to our Headers and Responses page for full details.
Requesting an individual API
The first thing you’ll want to do is to get a list of film ID’s and cinema ID’s. We don’t publish a list, but they are easy to obtain from the APIs.
Once you have those basic details, you’ll very quickly be able to pass the results into subsequent requests.
Full documentation for each API available, and associated query parameters can be found here.
There are also a selection of Frequently Asked Questions (FAQs) here.
Please note that access using CORS authentication is currently in development and will be available later in 2018.
The Evaluation API Key is limited to 75 requests. If you require any more, please contact firstname.lastname@example.org.
You will receive a HTTP 429 response if you exceed your quota.