Favorite Movies
Get the paginated list of favorite movies for an account.
Get the list of movies an account has marked as a favourite, with optional sorting and pagination.
async favorite_movies(params: AccountMediaListParams): Promise<AccountMovieListResponse>TMDB Reference: Favorite 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<AccountMovieItem> containing an array of AccountMovieItem objects.
Example
import { TMDB } from "@lorenzopant/tmdb";
const tmdb = new TMDB("your-access-token");
const favorites = await tmdb.account.favorite_movies({
account_id: 123,
sort_by: "created_at.desc",
page: 1,
});
console.log(favorites.results[0].title);