GET filmsComingSoon

Description

Return the top N films coming soon ordered by release date and number of showtimes in database (where available)

Example request

filmsComingSoon/?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 15.IntegerOptional

Caching

The returned data can be cached.

Returned Data

Returned KeyDescription
filmsArray – Containing details of films coming soon
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_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_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_rating_imageDescriptive 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": 258136,
            "imdb_id": 2119543,
            "imdb_title_id": "tt2119543",
            "film_name": "The House With A Clock In Its Walls",
            "other_titles": {
                "EN": "The House With A Clock In Its Walls"
            },
            "release_dates": [
                {
                    "release_date": "2018-09-21",
                    "notes": "GBR"
                }
            ],
            "age_rating": [
                {
                    "rating": "12A ",
                    "age_rating_image": "https://d2z9fe5yu2p0av.cloudfront.net/age_rating_logos/uk/12a.png",
                    "age_advisory": "moderate threat, scary scenes"
                }
            ],
            "film_trailer": "https://dzm1iom8kpoas.cloudfront.net/258136_uk_high.mp4",
            "synopsis_long": "In the tradition of Amblin classics where fantastical events occur in the most unexpected places, Jack Black and two-time Academy Award® winner Cate Blanchett star in THE HOUSE WITH A CLOCK IN ITS WALLS, from Amblin Entertainment.  The magical adventure tells the spine-tingling tale of 10-year-old Lewis (Owen Vaccaro) who goes to live with his uncle in a creaky old house with a mysterious tick-tocking heart.  But his new town's sleepy façade jolts to life with a secret world of warlocks and witches when Lewis accidentally awakens the dead.",
            "images": {
                "poster": {
                    "1": {
                        "image_orientation": "portrait",
                        "region": "US",
                        "medium": {
                            "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/258136/258136h1.jpg",
                            "width": 200,
                            "height": 300
                        }
                    }
                },
                "still": {
                    "2": {
                        "image_orientation": "landscape",
                        "medium": {
                            "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/258136/258136h2.jpg",
                            "width": 300,
                            "height": 199
                        }
                    }
                }
            }
        }
    ],
    "status": {
        "count": 1,
        "state": "OK",
        "method": "filmsComingSoon",
        "message": null,
        "request_method": "GET",
        "version": "ZUPIv200",
        "territory": "UK",
        "device_datetime_sent": "2018-09-14T09:26:34.793Z",
        "device_datetime_used": "2018-09-14 09:26:34"
    }
}