Method name
GET closestShowing
Description
Returns the nearest cinema showing the film, regardless of time and date, for a given film and location.
Example request
closestShowing/?film_id=123456
Required headers
| Sent header | Description | Data type | Optional / Mandatory |
|---|---|---|---|
| geolocation | Geolocation of end user, used to calculate distance of cinema from user. Format must be lat;lon for example 51.510391;-0.13013 | Latitude and Longitude | Mandatory |
Sent Arguments
| Sent argument | Description | Data type | Optional / Mandatory |
|---|---|---|---|
| film_id | The MovieGlu numeric internal film ID | Integer | Mandatory |
| n | Limit the number of returned results. Default is 5, System max is 20. | Integer | Optional |
Caching
The returned data should not be cached.
Returned data
| Returned Key | Description |
|---|---|
| film_id | The MovieGlu numeric internal film ID |
| imdb_id (deprecated) | The IMDB film ID (this field will be removed in the next API version) |
| imdb_title_id | The IMDB ID for the film title as used in IMDB URLs in the format tt#######. Recommended use: Concatenate URL “https://www.imdb.com/title/” and “imdb_title_id”, for example https://www.imdb.com/title/tt0076759/ |
| film_name | The film name |
| other_titles | |
| XX | Other titles that may exist, for example in another language XX denotes ISO language code, eg EN, FR or ES |
| cinemas | Array – Cinemas showing requested film in distance order |
| 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 |
| postcode | Zip code or post code |
| lat | Cinema latitude |
| lng | Cinema longitude |
| distance | Distance from user’s geolocation (if provided in header) |
| logo_url | Location of logo image for cinema (generally available for chains 4 or more cinemas, not all countries) |
| date | Date of closest showing |
| time | Time of closest showing |
Example response
{
"film_id": 227902,
"imdb_id": 3829266,
"imdb_title_id": "tt3829266",
"film_name": "The Predator",
"other_titles": {
"EN": "The Predator"
},
"cinemas": [
{
"cinema_id": 8922,
"cinema_name": "Vue Cinemas - Shepherds Bush",
"address": "West 12 Shopping and Leisure Centre",
"address2": "Shepherds Bush Green",
"city": "London",
"county": "Greater London",
"postcode": "W12 8PP",
"lat": 51.50893,
"lng": -0.21998,
"distance": 1.6461926320075,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-712-sq.jpg",
"date": "2018-09-14",
"time": "23:35"
},
{
"cinema_id": 23530,
"cinema_name": "Vue Cinemas - Westfield",
"address": "Ariel Way - Westfield Shopping Centre",
"address2": "",
"city": "London",
"county": "Greater London",
"postcode": "W12 7GF",
"lat": 51.507721,
"lng": -0.22106,
"distance": 1.6908886525841,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-712-sq.jpg",
"date": "2018-09-14",
"time": "15:45"
}
],
"status": {
"count": 5,
"state": "OK",
"method": "closestShowing",
"message": null,
"request_method": "GET",
"version": "MGv200",
"territory": "UK",
"device_datetime_sent": "2018-09-14T14:48:51.069Z",
"device_datetime_used": "2018-09-14 14:48:51"
}
}