Quick start guide

Introduction

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.

Postman users

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.

Target URL

https://api-gate.movieglu.com/

* 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

Example: https://api-gate.movieglu.com/filmsNowShowing/?n=10

Generating content

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.

Documentation

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.

Request Limit

The Evaluation API Key is limited to 75 requests. If you require any more, please contact support@movieglu.com.

You will receive a HTTP 429 response if you exceed your quota.