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"
}
}