Method name
- Quick start guide
- Troubleshooting
- Headers and Responses
- Sample code
- GET filmsNowShowing
- GET filmsComingSoon
- GET filmLiveSearch
- GET cinemaLiveSearch
- GET filmDetails
- GET cinemaDetails
- GET cinemasNearby
- GET cinemaShowTimes
- GET filmShowTimes
- GET closestShowing
- GET purchaseConfirmation
- GET images
- GET trailers
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 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 25. Typically there are around 10-15 films on general release at the same time. | Integer | Optional |
Caching
The returned data can be cached.
Returned data
| Returned key | Description |
|---|---|
| films | Array – Containing details of films now showing |
| 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_advisory | 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": 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"
}
}