Method name
- Quick start guide
- Troubleshooting
- Headers and Responses
- Sample code
- GET filmsNowShowing
- GET filmsComingSoon
- GET filmLiveSearch
- GET cinemaLiveSearch
- GET filmDetails
- GET cinemaDetails
- GET cinemasNearby
- GET cinemaShowTimes
- GET filmShowTimes
- GET closestShowing
- GET purchaseConfirmation
- GET images
- GET trailers
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 header | Description | Data type | Optional / Mandatory |
---|---|---|---|
geolocation | Geolocation 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 Longitude | Optional |
Sent Arguments
Sent argument | Description | Data type | Optional / Mandatory |
---|---|---|---|
cinema_id | The MovieGlu numeric internal cinema ID | Integer | Mandatory |
Caching
The returned data can be cached. API cannot be cached if geolocation is sent in header.
Returned data
Returned Key | Description |
---|---|
cinema_id | The MovieGlu numeric internal cinema ID |
cinema_name | The cinema name |
address | Cinema address line 1 |
address2 | Cinema address line 2 (where available) |
city | Cinema city |
county | Cinema county |
country | Cinema country |
postcode | Zip code or post code |
phone | Phone number of cinema |
lat | Cinema latitude |
lng | Cinema longitude |
distance | Distance in MILES from user’s geolocation (if provided in header) |
ticketing | If true (1) then cinema offers movietickets.com affiliate ticketing scheme |
directions | Directions to cinema |
logo_url | Location of logo image for cinema (generally available for chains 4 or more cinemas, not all countries) |
show_dates | Array – Dates when film is showing (useful for displaying a date selector for a cinema) |
date | List 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",
"address2": "Westminster",
"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": {
"count": 1,
"state": "OK",
"method": "cinemaDetails",
"message": null,
"request_method": "GET",
"version": "MGv200",
"territory": "UK",
"device_datetime_sent": "2018-09-14T14:03:40.979Z",
"device_datetime_used": "2018-09-14 14:03:40"
}
}