GET images

Description

Returns URL’s for images for a single specific film.

Example request

Images/?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. You can request all available sizes using size_category=all. 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
orientationOrientation: landscape,portrait – returns only that orientation. Default is BOTHStringOptional

Caching

The returned data can be cached.

Returned data

Returned KeyDescription
image_typeReturned Key will be either “poster” or “still”
image_referenceReturned Key is a sequential number, showing the recommended order or priority in which the images are displayed to your customer.
image_orientationLandscape or Portrait
regionFilm poster Country of origin (e.g US, UK) – Returned key only appears in poster grouping
size_categoryReturned Key is the Size Category of returned image. Categories are small, medium, large, Xlarge or XXLarge
film_imageLocation of image for film (URL)
widthWidth of image
heightHeight of image

Example response


{
  "poster": {
    "1": {
      "image_orientation": "portrait",
      "region": "US",
      "medium": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/161064h1.jpg",
        "width": 200,
        "height": 300
      },
      "small": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/16106401.jpg",
        "width": 100,
        "height": 150
      },
      "large": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/161064l1.jpg",
        "width": 333,
        "height": 500
      }
    }
  },
  "still": {
    "2": {
      "image_orientation": "landscape",
      "large": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/161064l2.jpg",
        "width": 500,
        "height": 333
      },
      "small": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/16106402.jpg",
        "width": 150,
        "height": 100
      },
      "medium": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/161064h2.jpg",
        "width": 300,
        "height": 200
      }
    },
    "3": {
      "image_orientation": "landscape",
      "large": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/161064l3.jpg",
        "width": 500,
        "height": 333
      },
      "small": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/16106403.jpg",
        "width": 150,
        "height": 100
      },
      "medium": {
        "film_image": "https://d3ltpb4h29tx4j.cloudfront.net/161064/161064h3.jpg",
        "width": 300,
        "height": 200
      }
    }
  }
}