Skip to main content
GET
/
collection
/
{collection_id}
/
images
Images
curl --request GET \
  --url https://api.themoviedb.org/3/collection/{collection_id}/images \
  --header 'Authorization: Bearer <token>'
{
  "backdrops": [
    {
      "aspect_ratio": 1.778,
      "height": 1080,
      "iso_639_1": "en",
      "file_path": "/wfnMt6LGqYHcNyOfsuusw5lX3bL.jpg",
      "vote_average": 7.19,
      "vote_count": 7,
      "width": 1920
    },
    {
      "aspect_ratio": 1.778,
      "height": 2160,
      "iso_639_1": null,
      "file_path": "/xN6SBJVG8jqqKQrgxthn3J2m49S.jpg",
      "vote_average": 7.05,
      "vote_count": 10,
      "width": 3840
    },
    {
      "aspect_ratio": 1.778,
      "height": 2160,
      "iso_639_1": null,
      "file_path": "/4gV0rKUjB1nLUdZB4zIltLvNZZr.jpg",
      "vote_average": 6.722,
      "vote_count": 9,
      "width": 3840
    },
    {
      "aspect_ratio": 1.778,
      "height": 1080,
      "iso_639_1": null,
      "file_path": "/hWK8gTH2riuv65Ej43hPSeE16Mu.jpg",
      "vote_average": 5.682,
      "vote_count": 11,
      "width": 1920
    },
    {
      "aspect_ratio": 1.778,
      "height": 2160,
      "iso_639_1": null,
      "file_path": "/dBPd75woR5g2CtelMM7t3sU52ST.jpg",
      "vote_average": 3.334,
      "vote_count": 3,
      "width": 3840
    },
    {
      "aspect_ratio": 1.778,
      "height": 1080,
      "iso_639_1": "en",
      "file_path": "/tpDcuXZGqEoU6CxuJ7e4S2NTIoS.jpg",
      "vote_average": 1.75,
      "vote_count": 8,
      "width": 1920
    },
    {
      "aspect_ratio": 1.778,
      "height": 720,
      "iso_639_1": "en",
      "file_path": "/lsmVL3S5QdIqEcOj6Yi5RyHAfma.jpg",
      "vote_average": 1.75,
      "vote_count": 4,
      "width": 1280
    },
    {
      "aspect_ratio": 1.778,
      "height": 1080,
      "iso_639_1": null,
      "file_path": "/3JDhQymLyezzEPlHbHpCzDSIZdQ.jpg"
    }
  ]
}
If you have a language specified, it will act as a filter on the returned items. You can use the include_image_language param to query additional languages.

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

The ID of the collection to retrieve

Query Parameters

include_image_language
string

Specify a comma separated list of ISO-639-1 values to query

language
string

Defaults to en-US

Response

200 - application/json

Successful

id
integer

A unique identifier for the collection

backdrops
object[]

A list of backdrop images related to the collection

posters
object[]

A list of poster images associated with the collection