GET
/
3
/
account
/
{account_id}
/
favorite
/
movies
curl --request GET \
  --url https://api.themoviedb.org/3/account/%7B{account_id}%7D/favorite/movies \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/h3fwlwHotd3JfV13HdW0mxDcxPD.jpg",
      "genre_ids": [
        35,
        10749,
        10770
      ],
      "id": 957119,
      "original_language": "en",
      "original_title": "Sidelined: The QB and Me",
      "overview": "Dallas, a burdened but headstrong dancer, is determined to get into the best dance school in the country—her late mother’s alma mater. However, that dream is suddenly derailed when the cheeky yet secretly grieving football star, Drayton, crashes into her life with a unique story of his own. Will the two of them be able to grow into their dreams together, or will their dreams be sidelined?",
      "popularity": 1605.297,
      "poster_path": "/sIWv5HtDlUFvacsuA1fRNWZ5GFH.jpg",
      "release_date": "2024-11-29",
      "title": "Sidelined: The QB and Me",
      "video": false,
      "vote_average": 6.5,
      "vote_count": 40
    },
    {
      "adult": false,
      "backdrop_path": "/euYIwmwkmz95mnXvufEmbL6ovhZ.jpg",
      "genre_ids": [
        28,
        12,
        36
      ],
      "id": 558449,
      "original_language": "en",
      "original_title": "Gladiator II",
      "overview": "Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people.",
      "popularity": 1244.766,
      "poster_path": "/2cxhvwyEwRlysAmRH4iodkvo0z5.jpg",
      "release_date": "2024-11-13",
      "title": "Gladiator II",
      "video": false,
      "vote_average": 6.654,
      "vote_count": 923
    }
  ],
  "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
string
required

This represents your account ID. Get it here

Query Parameters

​
language
string

This represents the movie language.

​
page
string

This represents the page number.

Example:

"1"

​
sort_by
string

This represents how the retrieved list will be arranged.

Example:

"created_at.asc"

Response

200 - application/json

Favorite Movies

The response is of type object.