Favorite Movies

This endpoint get user’s list of favorite movies.

GET /3/account/{account_id}/favorite/movies

Try it

Favorite Movies

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/account/{account_id}/favorite/movies \
  --header 'Authorization: Bearer <token>'

200

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/hZkgoQYus5vegHoetLkCJzb17zJ.jpg",
      "genre_ids": [
        18
      ],
      "id": 550,
      "original_language": "en",
      "original_title": "Fight Club",
      "overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.",
      "popularity": 97.965,
      "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
      "release_date": "1999-10-15",
      "title": "Fight Club",
      "video": false,
      "vote_average": 8.438,
      "vote_count": 29556
    }
  ],
  "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_id · integer · required

Query Parameters

language · string · default: en-US

language based on region

page · integer · default: 1

page number to retrieve specific paginated results.

session_id · string

session ID for authentication or tracking purposes

Example:

""

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

Favorite Movies

page · number

Example:

1

results · object[]

Show child attributes

results. adult · boolean

Example:

false

results. backdrop_path · string

Example:

"/hZkgoQYus5vegHoetLkCJzb17zJ.jpg"

results. genre_ids · number[]

Example:

[18]

results. id · number

Example:

550

results. original_language · string

Example:

"en"

results. original_title · string

Example:

"Fight Club"

results. overview · string

Example:

"A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion."

results. popularity · number

Example:

97.965

results. poster_path · string

Example:

"/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"

results. release_date · string

Example:

"1999-10-15"

results. title · string

Example:

"Fight Club"

results. video · boolean

Example:

false

results. vote_average · number

Example:

8.438

results. vote_count · number

Example:

29556

Example:

[
  {
    "adult": false,
    "backdrop_path": "/hZkgoQYus5vegHoetLkCJzb17zJ.jpg",
    "genre_ids": [18],
    "id": 550,
    "original_language": "en",
    "original_title": "Fight Club",
    "overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.",
    "popularity": 97.965,
    "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
    "release_date": "1999-10-15",
    "title": "Fight Club",
    "video": false,
    "vote_average": 8.438,
    "vote_count": 29556
  }
]

total_pages · number

Example:

1

total_results · number

Example:

1