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 headerDescriptionData typeOptional / Mandatory
NoneNoneNoneNone

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
film_idThe MovieGlu numeric internal film IDIntegerMandatory
size_categoryReturn 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.
– Small = 150px
– Medium = 300px
– Large = 500px
– XLarge = 1000px
– XXLarge = 1500px

StringOptional

Caching

The returned data can be cached.

Returned data

Returned KeyDescription
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_idThe 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_titlesOther titles that may exist, for example in another language, preceeded by the ISO language, eg EN, FR or ES
XXOther titles that may exist, for example in another language
XX denotes ISO language code, eg EN, FR or ES
version_typeOne of the following types: Standard, 3D, IMAX, IMAX3D, Other
imagesLocation and details of images for requested film
Please refer to the GET Images for format.
synopsis_longLong version of film synopsis (Usually 600 chars or less in most cases, but sometimes more)
distributor_idThe MovieGlu internal distributor id (US and UK only)
distributorThe distributor name (US and UK only)
release_datesThe release date of the film in format YYYY-MM-DD
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_advisoryDescriptive text accompanying age rating (where available)
duration_minsShowtime duration in minutes (not including advertising or trailers)
review_starsStar 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_txtHollywood.com review
trailersObject – Containing trailers for requested film
film_idThe MovieGlu numeric internal film ID
film_nameThe film name
trailersObject – Containing trailers for requested film
qualityArray – name varies according to quality of trailer. Contains trailer data.
film_trailerLocation of latest trailer released for film
trailer_imageLocation of suggested image for trailer overlay
versionVersion number (where multiple trailers have been released, highest number being the most recent trailer version)
qualityHigh (Default), others if available
regionLocal trailer, eg UK. If not availble then a default trailer from the US is provided.
genresArray – Contains list of genres
genre_idThe MovieGlu internal genre id
genre_nameThe genre name
castArray – Contains list of cast
cast_idThe MovieGlu internal cast id
cast_nameThe cast members name
directorsArray – Contains list of directors
directors_idThe MovieGlu internal director id
directors_nameThe directors name
producersArray – Contains list of producers
producers_idThe MovieGlu internal producer id
producers_nameThe producers name
writersArray – Contains list of writers
writers_idThe MovieGlu internal writer id
writers_nameThe writers name
show_datesArray – Contains list of dates when film is showing nationwide
dateList of dates in format yyyy-mm-dd
alternate_versionsArray – Containing details of alternate formats (3D, IMAX, etc) for this film
film_idThe MovieGlu numeric internal film ID
film_nameThe film name
version_typeOne 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"
    }
}