GET
/
3
/
account
/
{account_id}
/
watchlist
/
tv
curl --request GET \
  --url https://api.themoviedb.org/3/account/{account_id}/watchlist/tv \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/ynSOcgDLZfdLCZfRSYZGiTgYJVo.jpg",
      "first_air_date": "2018-06-20",
      "genre_ids": [
        37,
        18
      ],
      "id": 73586,
      "name": "Yellowstone",
      "origin_country": [
        "US"
      ],
      "original_language": "en",
      "original_name": "Yellowstone",
      "overview": "Follow the violent world of the Dutton family, who controls the largest contiguous ranch in the United States. Led by their patriarch John Dutton, the family defends their property against constant attack by land developers, an Indian reservation, and America’s first National Park.",
      "popularity": 817.843,
      "poster_path": "/s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg",
      "vote_average": 8.2,
      "vote_count": 2577
    },
    {
      "adult": false,
      "backdrop_path": "/zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg",
      "first_air_date": "2011-04-17",
      "genre_ids": [
        10765,
        18,
        10759
      ],
      "id": 1399,
      "name": "Game of Thrones",
      "origin_country": [
        "US"
      ],
      "original_language": "en",
      "original_name": "Game of Thrones",
      "overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
      "popularity": 957.562,
      "poster_path": "/1XS1oqL89opfnbLl8WnZY1O1uJx.jpg",
      "vote_average": 8.5,
      "vote_count": 24463
    }
  ],
  "total_pages": 1,
  "total_results": 2
}

Authorizations

Authorization
string
header
required

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

Path Parameters

account_id
integer
required

unique identifier of an account

Query Parameters

page
integer
default:1

page number to retrieve specific paginated results.

session_id
string

session ID for authentication or tracking purposes

language
string
default:en-US

language based on region

sort_by
enum<string>

Sort the results either in ascending order or descending order

Available options:
created_at.asc,
created_at.desc

Response

200 - application/json

Watchlist TV

page
number
Example:

1

results
object[]
Example:
[
{
"adult": false,
"backdrop_path": "/ynSOcgDLZfdLCZfRSYZGiTgYJVo.jpg",
"first_air_date": "2018-06-20",
"genre_ids": [37, 18],
"id": 73586,
"name": "Yellowstone",
"origin_country": ["US"],
"original_language": "en",
"original_name": "Yellowstone",
"overview": "Follow the violent world of the Dutton family, who controls the largest contiguous ranch in the United States. Led by their patriarch John Dutton, the family defends their property against constant attack by land developers, an Indian reservation, and America’s first National Park.",
"popularity": 817.843,
"poster_path": "/s4QRRYc1V2e68Qy9Wel9MI8fhRP.jpg",
"vote_average": 8.2,
"vote_count": 2577
},
{
"adult": false,
"backdrop_path": "/zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg",
"first_air_date": "2011-04-17",
"genre_ids": [10765, 18, 10759],
"id": 1399,
"name": "Game of Thrones",
"origin_country": ["US"],
"original_language": "en",
"original_name": "Game of Thrones",
"overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
"popularity": 957.562,
"poster_path": "/1XS1oqL89opfnbLl8WnZY1O1uJx.jpg",
"vote_average": 8.5,
"vote_count": 24463
}
]
total_pages
number
Example:

1

total_results
number
Example:

2

Welcome to TMDB API Documentation!
⚠️ This documentation uses the TMDB API but is not endorsed or certified by TMDB.