Rated Movies
Get the paginated list of movies rated by an account.
Get the list of movies an account has rated, with optional sorting and pagination.
async rated_movies(params: AccountMediaListParams): Promise<AccountRatedMoviesResponse>TMDB Reference: Rated Movies
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id | number | ✅ | The TMDB account ID. |
session_id | string | ❌ | Session ID for v3 session-based authentication. |
language | Language | ❌ | Language for localized results. Defaults to en-US. |
sort_by | AccountSortBy | ❌ | Sort order: "created_at.asc" or "created_at.desc". |
page | number | ❌ | Page number to return. |
Returns
A PaginatedResponse<AccountRatedMovieItem> containing an array of AccountRatedMovieItem objects. Each item includes a rating field with the user's score (0.5–10).
Example
import { TMDB } from "@lorenzopant/tmdb";
const tmdb = new TMDB("your-access-token");
const rated = await tmdb.account.rated_movies({ account_id: 123 });
console.log(rated.results[0].title);
console.log(rated.results[0].rating); // 8.5