Method name
GET images
Description
Returns URL’s for images for a single specific film.
Example request
images/?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. 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. | String | Optional |
| orientation | Orientation: landscape,portrait – returns only that orientation. Default is BOTH | String | Optional |
Caching
The returned data can be cached.
Returned data
| Returned Key | Description |
|---|---|
| image_type | Returned Key will be either “poster” or “still” |
| image_reference | Returned Key is a single alphanumeric character (i.e 1-9, a-k) |
| image_orientation | Landscape or Portrait |
| region | Film poster Country of origin (e.g US, UK) – Returned key only appears in poster grouping |
| size_category | Returned Key is the Size Category of returned image. Categories are small, medium, large, Xlarge or XXLarge |
| film_image | Location of image for film (URL) |
| width | Width of image |
| height | Height 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"
}
}