GET
/
3
/
collection
/
{collection_id}
/
images
curl --request GET \
  --url https://api.themoviedb.org/3/collection/{collection_id}/images \
  --header 'Authorization: Bearer <token>'
{
  "backdrops": [
    {
      "aspect_ratio": 1.778,
      "file_path": "/zJU3dyafiEPdH29h7NKJGj7u7cu.jpg",
      "height": 720,
      "iso_639_1": null,
      "vote_average": 0,
      "vote_count": 0,
      "width": 1280
    },
    {
      "aspect_ratio": 1.778,
      "file_path": "/3gtOIe1zDAjDHxAyMEvdHXMveeM.jpg",
      "height": 1080,
      "iso_639_1": null,
      "vote_average": 0,
      "vote_count": 0,
      "width": 1920
    }
  ],
  "id": 456,
  "posters": [
    {
      "aspect_ratio": 0.667,
      "file_path": "/4tVV2YsrhK2hi43LlqNBRBvmsIQ.jpg",
      "height": 1500,
      "iso_639_1": "de",
      "vote_average": 1.066,
      "vote_count": 5,
      "width": 1000
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/zU0K7n1LJjMIfQLP4fva8TpG3Qp.jpg",
      "height": 1650,
      "iso_639_1": "es",
      "vote_average": 3.334,
      "vote_count": 1,
      "width": 1100
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/oL6vDCFuWaJPVskZJXnclPgYHRz.jpg",
      "height": 1500,
      "iso_639_1": "de",
      "vote_average": 3.334,
      "vote_count": 1,
      "width": 1000
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/kKmWGoKpoQZcoJzcFQQlybfxUWb.jpg",
      "height": 1650,
      "iso_639_1": "de",
      "vote_average": 2.542,
      "vote_count": 4,
      "width": 1100
    },
    {
      "aspect_ratio": 0.731,
      "file_path": "/leXP2ToG7cTjJTD3lQkRz63YgrO.jpg",
      "height": 1119,
      "iso_639_1": "es",
      "vote_average": 0.666,
      "vote_count": 3,
      "width": 818
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/q3TRq5zEtObaJ09mUIlHb8hD0e2.jpg",
      "height": 1500,
      "iso_639_1": "es",
      "vote_average": 0.166,
      "vote_count": 1,
      "width": 1000
    },
    {
      "aspect_ratio": 0.699,
      "file_path": "/aUorCQ1HUaMPpvuILjH2S4FWlZa.jpg",
      "height": 787,
      "iso_639_1": "nl",
      "vote_average": 0,
      "vote_count": 0,
      "width": 550
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/z3rnpXayerdbIMMuVm2dBJeoHwB.jpg",
      "height": 750,
      "iso_639_1": "it",
      "vote_average": 0,
      "vote_count": 0,
      "width": 500
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/rTMRGUPwmhiBXsF38hwYhc1sInK.jpg",
      "height": 1500,
      "iso_639_1": "en",
      "vote_average": 0,
      "vote_count": 0,
      "width": 1000
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
collection_id
integer
required

a uniques identfier for a movie or tv collection

Example:

456

Query Parameters

​
include_image_language
string

A comma-separated list of ISO 639-1 language codes to filter images by language. Use null to include images without a language tag. Example- en,null to retrieve images in English and those without a specified language. For more information, refer to the documentation.

​
language
string

The language in which to retrieve movie details, specified using an ISO 639-1 code (e.g., "en" for English, "fr" for French).

Response

200 - application/json

Images

The response is of type object.