GET cinemaDetails

Description

Returns the metadata for a single specific cinema, including name, address, logo

Example request

cinemaDetails/?cinema_id=12345

Notes

If you plan to provide a “Directions” service using Google Maps or similar, then we recommend you use the Latitude / Longitude of the cinema, rather than the postcode, as it will be more accurate in most cases.

Required headers

Sent headerDescriptionData typeOptional / Mandatory
geolocationGeolocation of end user, used to calculate distance of cinema from user. API cannot be cached if this option is used, which has a small affect on latency.
Format must be lat;lon for example 51.510391;-0.13013
Latitude and LongitudeOptional

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
cinema_idThe MovieGlu numeric internal cinema IDIntegerMandatory

Caching

The returned data can be cached.  API cannot be cached if geolocation is sent in header.

Returned data

Returned KeyDescription
cinema_idThe MovieGlu numeric internal cinema ID
cinema_nameThe cinema name
addressCinema address
cityCinema city
countyCinema county
countryCinema country
postcodeZip code or post code
phonePhone number of cinema
latCinema latitude
lngCinema longitude
distanceDistance from user’s geolocation (if provided in header)
ticketingIf true (1) then cinema offers movietickets.com affiliate ticketing scheme
directionsDirections to cinema
logo_urlLocation of logo image for cinema (generally available for chains 4 or more cinemas)
show_datesArray – Dates when film is showing (useful for displaying a date selector for a cinema)
dateList of dates in format yyyy-mm-dd, when showtimes are available at selected cinema

Example response


{
  "cinema_id": 8795,
  "cinema_name": "ODEON Leicester Square",
  "address": "24-26 Leicester Square",
  "city": "London",
  "county": "Greater London",
  "country": "GBR",
  "postcode": "WC2H 7JY",
  "phone": "(0871) 224 4007",
  "lat": 51.510479,
  "lng": -0.12952,
  "distance": 69.091511207949,
  "ticketing": 0,
  "directions": "",
  "logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-614-sq.jpg",
  "show_dates": [
    {
      "date": "2017-02-08"
    },
    {
      "date": "2017-02-09"
    },
    {
      "date": "2017-02-10"
    },
    {
      "date": "2017-02-11"
    },
    {
      "date": "2017-02-12"
    },
    {
      "date": "2017-02-13"
    },
    {
      "date": "2017-02-14"
    }
  ],
  "status": {
    "state": "OK",
    "code": 1,
    "method": "cinemaDetails",
    "message": null,
    "request_method": "GET",
    "version": "MGv101"
  }
}