Images

Get the images that belong to a collection.

This method will return the backdrops and posters that have been added to a collection.

📘Note:

If you have a language specified, it will act as a filter on the returned items. You can use the include_image_language parameter to query additional languages.

GET /3/collection/{collection_id}/images

Try it

Images

cURL

curl --request GET \
  --url 'https://api.themoviedb.org/3/collection/{{collection_id}}/images'

200

{
  "backdrops": [
    {
      "aspect_ratio": 1.779,
      "file_path": "/mxKADQjfnhcb8mCBCii9aKMQVVW.jpg",
      "height": 1686,
      "iso_639_1": null,
      "vote_average": 0,
      "vote_count": 0,
      "width": 3000
    }
  ],
  "id": 591122,
  "posters": [
    {
      "aspect_ratio": 0.667,
      "file_path": "/qqrBeINPOFr2FLD4EeBLI90PzHo.jpg",
      "height": 1500,
      "iso_639_1": "en",
      "vote_average": 3.334,
      "vote_count": 1,
      "width": 1000
    },
    {
      "aspect_ratio": 0.667,
      "file_path": "/dK0yZ0zDY5UW9OqZkDJTkr7vWXz.jpg",
      "height": 1500,
      "iso_639_1": "en",
      "vote_average": 0,
      "vote_count": 0,
      "width": 1000
    }
  ]
}

Path Parameters

collection_id · string · required

Query Parameters

language · string

Specify the language for the images.

include_image_language · string

Include additional languages for images.

Response

200 - application/json

Images

backdrops · object[]

Show child attributes

backdrops. aspect_ratio · number

Example:

1.779

backdrops. file_path · string

Example:

"/mxKADQjfnhcb8mCBCii9aKMQVVW.jpg"

backdrops. height · number

Example:

1686

backdrops. iso_639_1 · unknown

backdrops. vote_average · number

Example:

0

backdrops. vote_count · number

Example:

0

backdrops. width · number

Example:

3000

Example:

[
  {
    "aspect_ratio": 1.779,
    "file_path": "/mxKADQjfnhcb8mCBCii9aKMQVVW.jpg",
    "height": 1686,
    "iso_639_1": null,
    "vote_average": 0,
    "vote_count": 0,
    "width": 3000
  }
]

id · number

Example:

591122

posters · object[]

Show child attributes

posters. aspect_ratio · number

Example:

0.667

posters. file_path · string

Example:

"/qqrBeINPOFr2FLD4EeBLI90PzHo.jpg"

posters. height · number

Example:

1500

posters. iso_639_1 · string

Example:

"en"

posters. vote_average · number

Example:

3.334

posters. vote_count · number

Example:

1

posters. width · number

Example:

1000

Example:

[
  {
    "aspect_ratio": 0.667,
    "file_path": "/qqrBeINPOFr2FLD4EeBLI90PzHo.jpg",
    "height": 1500,
    "iso_639_1": "en",
    "vote_average": 3.334,
    "vote_count": 1,
    "width": 1000
  },
  {
    "aspect_ratio": 0.667,
    "file_path": "/dK0yZ0zDY5UW9OqZkDJTkr7vWXz.jpg",
    "height": 1500,
    "iso_639_1": "en",
    "vote_average": 0,
    "vote_count": 0,
    "width": 1000
  }
]