Method name

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 single alphanumeric character (i.e 1-9, a-k)
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
      }
    }
   "status": {
        "count": 10,
        "state": "OK",
        "method": "images",
        "message": null,
        "request_method": "GET",
        "version": "UKv200",
        "territory": "UK",
        "device_datetime_sent": "2018-09-14T14:55:38.257Z",
        "device_datetime_used": "2018-09-14 14:55:38"
  }
}