GET cinemaLiveSearch


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


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


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
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)

Example response

    "cinemas": [
            "cinema_id": 35466,
            "cinema_name": "ODEON The Lounge Whiteleys",
            "address": "Whiteleys of Bayswater",
            "city": "London",
            "postcode": "W2 4YL",
            "lat": 51.517021,
            "lng": -0.18874,
            "distance": 2.4165345126618,
            "logo_url": ""
            "cinema_id": 8913,
            "cinema_name": "ODEON Whiteleys - London",
            "address": "Whiteleys of Bayswater",
            "city": "London",
            "postcode": "W2 4YL",
            "lat": 51.514568,
            "lng": -0.18812,
            "distance": 2.5031829833123,
            "logo_url": ""
            "cinema_id": 8798,
            "cinema_name": "ODEON Swiss Cottage",
            "address": "96 Finchley Road",
            "city": "London",
            "postcode": "NW3 5EL",
            "lat": 51.542542,
            "lng": -0.17494,
            "distance": 3.0222170269911,
            "logo_url": ""
  "count": 3,
  "status": {
    "state": "OK",
    "code": 1,
    "method": "cinemaLiveSearch",
    "message": null,
    "request_method": "GET",
    "version": "MGv101"