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 filmDetails
Description
Returns the metadata, images and trailers for a single specific film, including title, synopsis, cast, etc
Example request
filmDetails/?film_id=12345
Required headers
| Sent header | Description | Data type | Optional / Mandatory |
|---|---|---|---|
| None | None | None | None |
Sent Arguments
| Sent argument | Description | Data type | Optional / Mandatory |
|---|---|---|---|
| film_id | The MovieGlu numeric internal film ID | Integer | Mandatory |
| size_category | Return images for film in particular size. If none are requested, then medium will be returned by default. You can request multiple sizes as comma separated values, e.g. size_category=small,medium. Please note that not all sizes contain the same number of images.
Valid values are as follows. The number of pixels denotes the longest edge . Note: the larger the image category, the fewer images are available. | String | Optional |
Caching
The returned data can be cached.
Returned data
| Returned Key | Description |
|---|---|
| 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 | Other titles that may exist, for example in another language, preceeded by the ISO language, eg EN, FR or ES |
| XX | Other titles that may exist, for example in another language XX denotes ISO language code, eg EN, FR or ES |
| version_type | One of the following types: Standard, 3D, IMAX, IMAX3D, Other |
| images | Location and details of images for requested film Please refer to the GET Images for format. |
| synopsis_long | Long version of film synopsis (Usually 600 chars or less in most cases, but sometimes more) |
| distributor_id | The MovieGlu internal distributor id (US and UK only) |
| distributor | The distributor name (US and UK only) |
| release_dates | The release date of the film in format YYYY-MM-DD |
| 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) |
| duration_mins | Showtime duration in minutes (not including advertising or trailers) |
| review_stars | Star rating out of 5 provided by hollywood.com. Important: This field can contain scores such as 3 or 3.5. Due to a common issue with JSON encoding output, we recommend that you treat this field as a NUMBER, rather than an integer or float. |
| review_txt | Hollywood.com review |
| trailers | Object – Containing trailers for requested film |
| film_id | The MovieGlu numeric internal film ID |
| film_name | The film name |
| trailers | Object – Containing trailers for requested film |
| quality | Array – name varies according to quality of trailer. Contains trailer data. |
| film_trailer | Location of latest trailer released for film |
| trailer_image | Location of suggested image for trailer overlay |
| version | Version number (where multiple trailers have been released, highest number being the most recent trailer version) |
| quality | High (Default), others if available |
| region | Local trailer, eg UK. If not availble then a default trailer from the US is provided. |
| genres | Array – Contains list of genres |
| genre_id | The MovieGlu internal genre id |
| genre_name | The genre name |
| cast | Array – Contains list of cast |
| cast_id | The MovieGlu internal cast id |
| cast_name | The cast members name |
| directors | Array – Contains list of directors |
| directors_id | The MovieGlu internal director id |
| directors_name | The directors name |
| producers | Array – Contains list of producers |
| producers_id | The MovieGlu internal producer id |
| producers_name | The producers name |
| writers | Array – Contains list of writers |
| writers_id | The MovieGlu internal writer id |
| writers_name | The writers name |
| show_dates | Array – Contains list of dates when film is showing nationwide |
| date | List of dates in format yyyy-mm-dd |
| alternate_versions | Array – Containing details of alternate formats (3D, IMAX, etc) for this film |
| film_id | The MovieGlu numeric internal film ID |
| film_name | The film name |
| version_type | One of the following types: Standard, 3D, IMAX, IMAX3D |
Example response
{
"film_id": 227902,
"imdb_id": 3829266,
"imdb_title_id": "tt3829266",
"film_name": "The Predator",
"other_titles": {
"EN": "The Predator"
},
"version_type": "Standard",
"images": {
"poster": {
"1": {
"image_orientation": "portrait",
"region": "global",
"medium": {
"film_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/IND_227902h0.jpg",
"width": 202,
"height": 300
}
}
},
"still": {
"1": {
"image_orientation": "landscape",
"medium": {
"film_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h2.jpg",
"width": 300,
"height": 199
}
},
"2": {
"image_orientation": "landscape",
"medium": {
"film_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h3.jpg",
"width": 300,
"height": 200
}
}
},
"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.....",
"distributor_id": 47,
"distributor": "Fox Int'l",
"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"
}
],
"duration_mins": 101,
"review_stars": 2,
"review_txt": "Predator is one of those tired franchises that Hollywood simply won't give up on.....",
"trailers": {
"high": [
{
"film_trailer": "https://dzm1iom8kpoas.cloudfront.net/227902_uk_high.mp4",
"trailer_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h3.jpg",
"version": 1,
"quality": "high",
"region": "UK"
}
],
"med": [
{
"film_trailer": "https://dzm1iom8kpoas.cloudfront.net/227902_uk_med.mp4",
"trailer_image": "https://d3ltpb4h29tx4j.cloudfront.net/227902/227902h3.jpg",
"version": 1,
"quality": "med",
"region": "UK"
}
]
},
"genres": [
{
"genre_id": 5,
"genre_name": "Action/Aventure"
}
],
"cast": [
{
"cast_id": 13906,
"cast_name": "Boyd Holbrook"
},
{
"cast_id": 13907,
"cast_name": "Trevante Rhodes"
},
{
"cast_id": 13050,
"cast_name": "Jacob Tremblay"
}
],
"directors": [
{
"director_id": 3549,
"director_name": "Shane Black"
}
],
"producers": [
{
"producer_id": 1884,
"producer_name": "John Davis"
}
],
"writers": [
{
"writer_id": 4024,
"writer_name": "Fred Dekker"
}
],
"show_dates": [
{
"date": "2018-09-14"
},
{
"date": "2018-09-15"
}
],
"alternate_versions": [
{
"film_id": 275653,
"film_name": "The Predator: The IMAX 2D Experience",
"version_type": "IMAX"
},
{
"film_id": 277058,
"film_name": "The Predator: An IMAX 3D Experience",
"version_type": "IMAX3D"
},
{
"film_id": 277426,
"film_name": "The Predator 3D",
"version_type": "3D"
}
],
"status": {
"count": 1,
"state": "OK",
"method": "filmDetails",
"message": null,
"request_method": "GET",
"version": "MGv200",
"territory": "UK",
"device_datetime_sent": "2018-09-14T13:08:06.861Z",
"device_datetime_used": "2018-09-14 13:08:06"
}
}