GET
/
3
/
account
/
{account_id}
/
rated
/
movies
Rated Movie
curl --request GET \
  --url https://api.themoviedb.org/3/account/{account_id}/rated/movies \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/dWkdmxIkH9y23s9v1PjQFhTGIwo.jpg",
      "genre_ids": [
        28,
        18,
        53,
        10752
      ],
      "id": 1043905,
      "original_language": "en",
      "original_title": "Dirty Angels",
      "overview": "During the United States' 2021 withdrawal from Afghanistan, a group of female soldiers posing as medical relief are sent back in to rescue a group of kidnapped teenagers caught between ISIS and the Taliban.",
      "popularity": 570.378,
      "poster_path": "/3O3qSGmjRGc10hMwFul8WDxKE5t.jpg",
      "rating": 9,
      "release_date": "2024-12-11",
      "title": "Dirty Angels",
      "video": false,
      "vote_average": 6.4,
      "vote_count": 158
    },
    {
      "adult": false,
      "backdrop_path": "/eCynaAOgYYiw5yN5lBwz3IxqvaW.jpg",
      "genre_ids": [
        16,
        10751
      ],
      "id": 12,
      "original_language": "en",
      "original_title": "Finding Nemo",
      "overview": "Nemo, an adventurous young clownfish, is unexpectedly taken from his Great Barrier Reef home to a dentist's office aquarium. It's up to his worrisome father Marlin and a friendly but forgetful fish Dory to bring Nemo home -- meeting vegetarian sharks, surfer dude turtles, hypnotic jellyfish, hungry seagulls, and more along the way.",
      "popularity": 105.743,
      "poster_path": "/eHuGQ10FUzK1mdOY69wF5pGgEf5.jpg",
      "rating": 8.5,
      "release_date": "2003-05-30",
      "title": "Finding Nemo",
      "video": false,
      "vote_average": 7.819,
      "vote_count": 19375
    }
  ],
  "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

Rated Movie

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/dWkdmxIkH9y23s9v1PjQFhTGIwo.jpg",
    "genre_ids": [28, 18, 53, 10752],
    "id": 1043905,
    "original_language": "en",
    "original_title": "Dirty Angels",
    "overview": "During the United States' 2021 withdrawal from Afghanistan, a group of female soldiers posing as medical relief are sent back in to rescue a group of kidnapped teenagers caught between ISIS and the Taliban.",
    "popularity": 570.378,
    "poster_path": "/3O3qSGmjRGc10hMwFul8WDxKE5t.jpg",
    "rating": 9,
    "release_date": "2024-12-11",
    "title": "Dirty Angels",
    "video": false,
    "vote_average": 6.4,
    "vote_count": 158
  },
  {
    "adult": false,
    "backdrop_path": "/eCynaAOgYYiw5yN5lBwz3IxqvaW.jpg",
    "genre_ids": [16, 10751],
    "id": 12,
    "original_language": "en",
    "original_title": "Finding Nemo",
    "overview": "Nemo, an adventurous young clownfish, is unexpectedly taken from his Great Barrier Reef home to a dentist's office aquarium. It's up to his worrisome father Marlin and a friendly but forgetful fish Dory to bring Nemo home -- meeting vegetarian sharks, surfer dude turtles, hypnotic jellyfish, hungry seagulls, and more along the way.",
    "popularity": 105.743,
    "poster_path": "/eHuGQ10FUzK1mdOY69wF5pGgEf5.jpg",
    "rating": 8.5,
    "release_date": "2003-05-30",
    "title": "Finding Nemo",
    "video": false,
    "vote_average": 7.819,
    "vote_count": 19375
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

2