GET filmsNowShowing

Description

Returns the top N films now showing, ordered by number of showtimes in database.

Example request

filmsNowShowing/?n=10

Required headers

Sent headerDescriptionData typeOptional / Mandatory
NoneNoneNoneNone

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
nLimit the number of returned results. Default is 10, System max is 25. Typically there are around 10-15 films on general release at the same time.IntegerOptional

Caching

The returned data can be cached.

Returned data

Returned keyDescription
filmsArray – Containing details of films now showing
film_idThe MovieGlu numeric internal film ID
imdb_id (deprecated)The IMDB film ID (this field will be removed in the next API version)
imdb_title_idThe 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_nameThe film name
other_titles
XXOther titles that may exist, for example in another language
XX denotes ISO language code, eg EN, FR or ES
release_dates
release_dateThe release date of the film in format YYYY-MM-DD
notesIn the United States, this includes information such as previews and releases in different cities
age_rating
ratingAge rating for film
age_rating_imageAge rating image location (where available)
age_advisoryDescriptive text accompanying age rating (where available)
film_trailerLocation of latest trailer released for film
synopsis_longLong version of film synopsis (Usually 600 chars or less in most cases, but sometimes more)
imagesLocation and details of primary images for film.
Please refer to the GET Images for format.
NOTE: Only the film poster and one still will be returned

Example response


{
    "films": [
        {
            "film_id": 227902,
            "imdb_id": 3829266,
            "imdb_title_id": "tt3829266",
            "film_name": "The Predator",
            "other_titles": {
                "EN": "The Predator"
            },
            "release_dates": [
                {
                    "release_date": "2018-09-12",
                    "notes": "GBR"
                }
            ],
            "age_rating": [
                {
                    "rating": "15 ",
                    "age_rating_image": "https://d2z9fe5yu2p0av.cloudfront.net/age_rating_logos/uk/15.png",
                    "age_advisory": "strong bloody violence, sex references, language"
                }
            ],
            "film_trailer": "https://dzm1iom8kpoas.cloudfront.net/227902_high.mp4",
            "synopsis_long": "From the outer reaches of space to the small-town streets of suburbia, the hunt comes home in Shane Black's explosive reinvention of the Predator series. Now, the universe's most lethal hunters are stronger, smarter and deadlier than ever before, having genetically upgraded themselves with DNA from other species. When a young boy accidentally triggers their return to Earth, only a ragtag crew of ex-soldiers and a disgruntled science teacher can prevent the end of the human race.",
            "images": {
                "poster": {
                    "1": {
                        "image_orientation": "portrait",
                        "region": "US",
                        "medium": {
                            "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h1.jpg",
                            "width": 200,
                            "height": 300
                        }
                    }
                },
                "still": {
                    "2": {
                        "image_orientation": "landscape",
                        "medium": {
                            "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h2.jpg",
                            "width": 300,
                            "height": 199
                        }
                    }
                }
            }
        }
    ],
    "status": {
        "count": 1,
        "state": "OK",
        "method": "filmsNowShowing",
        "message": null,
        "request_method": "GET",
        "version": "MGv200",
        "territory": "UK",
        "device_datetime_sent": "2018-09-14T09:16:49.618Z",
        "device_datetime_used": "2018-09-14 09:16:49"
    }
}