Method name
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 header | Description | Data type | Optional / Mandatory |
---|---|---|---|
None | None | None | None |
Sent Arguments
Sent argument | Description | Data type | Optional / Mandatory |
---|---|---|---|
n | Limit the number of returned results. Default is 10, System max is 15. | Integer | Optional |
Caching
The returned data can be cached.
Returned Data
Returned Key | Description |
---|---|
films | Array – Containing details of films coming soon |
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 |
release_dates | |
release_date | The release date of the film in format YYYY-MM-DD |
notes | In the United States, this includes information such as previews and releases in different cities |
age_rating | |
rating | Age rating for film |
age_rating_image | Age rating image location (where available) |
age_rating_image | Descriptive text accompanying age rating (where available) |
film_trailer | Location of latest trailer released for film |
synopsis_long | Long version of film synopsis (Usually 600 chars or less in most cases, but sometimes more) |
images | Location 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"
}
}