GET cinemaLiveSearch

Description

Returns cinema names, or town/city matches for a search string. Useful for search as you type or standard search. Works best with geolocation (Optional) within 75 miles.  For ‘search as you type’, send a request after every character entered in your app’s search field.

Example request

cinemaLiveSearch/?query=odeon+cinemas

Recommendation: If you are using this feature to implement a “Search as you type” solution, we recommend that you implement a short delay before submitting the request, to detect if the user has stopped typing, or submit after every three or four characters. This way you will consume fewer API requests.

Required headers

Sent headerDescriptionData typeOptional / Mandatory
geolocationGeolocation of end user. Optional, but recommended.
Format must be lat;lon for example 51.510391;-0.13013
Latitude and LongitudeOptional

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
queryThe search string to be queried (URL encoded), for example query=odeon. You must submit a minimum of three characters.StringMandatory
nLimit the number of returned results. Default is 5, System max is 25.IntegerOptional

Caching

The returned should not be cached.

Returned data

Returned Key
cinemasArray – containing details of cinemas matching search criteria
cinema_idThe MovieGlu numeric internal cinema ID
cinema_nameThe Cinema name
addressCinema address line 1
address2Cinema address line 2
cityCity in which cinema is found
postcodeZip code or post code of cinema
latCinema latitude
lngCinema longitude
distanceDistance from users geolocation (if provided)
logo_urlLocation of logo image for cinema (generally available for chains 4 or more cinemas, not all countries)

Example response


{
    "cinemas": [
        {
            "cinema_id": 10195,
            "cinema_name": "Reading Film Theatre",
            "address": "Palmer Building",
            "city": "Reading",
            "postcode": "RG6 2AH",
            "logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-1221-sq.jpg"
        },
        {
            "cinema_id": 8509,
            "cinema_name": "Showcase Cinema de Lux Reading",
            "address": "Loddon Bridge - Reading Road",
            "city": "Wokingham",
            "postcode": "RG41 5HG",
            "logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-577-sq.jpg"
        },
        {
            "cinema_id": 8941,
            "cinema_name": "Vue Cinemas - Reading",
            "address": "Riverside Level, The Oracle Shopping Centre",
            "city": "Reading",
            "postcode": "RG1 2AG",
            "logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-712-sq.jpg"
        }
    ],
    "status": {
        "count": 3,
        "state": "OK",
        "method": "cinemaLiveSearch",
        "message": null,
        "request_method": "GET",
        "version": "MGv200",
        "territory": "UK",
        "device_datetime_sent": "2018-09-14T13:24:40.718Z",
        "device_datetime_used": "2018-09-14 13:24:40"
    }
}