Watchlist Movies

This endpoint get a users movie watchlist.

GET /4/account/{account_object_id}/movie/watchlist

Try it

Watchlist Movies

cURL

curl --request GET \
  --url https://api.themoviedb.org/4/account/{account_object_id}/movie/watchlist \
  --header 'Authorization: Bearer <token>'

200

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/2w4xG178RpB4MDAIfTkqAuSJzec.jpg",
      "genre_ids": [
        12,
        28,
        878
      ],
      "id": 11,
      "original_language": "en",
      "original_title": "Star Wars",
      "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.",
      "popularity": 122.735,
      "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
      "release_date": "1977-05-25",
      "title": "Star Wars",
      "video": false,
      "vote_average": 8.203,
      "vote_count": 20920
    }
  ],
  "total_pages": 1,
  "total_results": 1
}

Authorizations

Authorization · string · header · required

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

Path Parameters

account_object_id · string · required

Query Parameters

page · integer · default: 1

the page number

language · string · default: en-US

The ISO 639-1 code for the language

sort_by · enum<string>

Available options: created_at.asc, created_at.desc

Response

200 - application/json

Watchlist Movies

page · number

Example:

1

results · object[]

Show child attributes

results. adult · boolean

Example:

false

results. backdrop_path · string

Example:

"/2w4xG178RpB4MDAIfTkqAuSJzec.jpg"

results. genre_ids · number[]

Example:

[12, 28, 878]

results. id · number

Example:

11

results. original_language · string

Example:

"en"

results. original_title · string

Example:

"Star Wars"

results. overview · string

Example:

"Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire."

results. popularity · number

Example:

122.735

results. poster_path · string

Example:

"/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg"

results. release_date · string

Example:

"1977-05-25"

results. title · string

Example:

"Star Wars"

results. video · boolean

Example:

false

results. vote_average · number

Example:

8.203

results. vote_count · number

Example:

20920

Example:

[
  {
    "adult": false,
    "backdrop_path": "/2w4xG178RpB4MDAIfTkqAuSJzec.jpg",
    "genre_ids": [12, 28, 878],
    "id": 11,
    "original_language": "en",
    "original_title": "Star Wars",
    "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.",
    "popularity": 122.735,
    "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
    "release_date": "1977-05-25",
    "title": "Star Wars",
    "video": false,
    "vote_average": 8.203,
    "vote_count": 20920
  }
]

total_pages · number

Example:

1

total_results · number

Example:

1