Details
Get the top level details of a movie by ID.
Get the top level details of a movie by ID. Supports appending sub-resources in a single request via append_to_response.
async details<T extends readonly MovieAppendToResponseNamespace[] = []>(
params: MovieDetailsParams & { append_to_response?: T }
): Promise<T extends [] ? MovieDetails : MovieDetailsWithAppends<T>>TMDB Reference: Movie Details
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
movie_id | number | ✅ | TMDB movie identifier. |
append_to_response | MovieAppendToResponseNamespace[] | ❌ | Sub-resources to append to the response. |
language | Language | ❌ | Language for localized results. Defaults to en-US. |
Returns
MovieDetails when no appends are provided,
or MovieDetailsWithAppends<T> when append_to_response is specified.
Example
// Basic details
const movie = await tmdb.movies.details({ movie_id: 550 });
console.log(movie.title); // "Fight Club"
// With appended data
const movie = await tmdb.movies.details({
movie_id: 550,
append_to_response: ["credits", "videos", "images"],
});
console.log(movie.credits.cast);
console.log(movie.videos.results);