Details
Query the top-level details of a person.
async details(params: PersonDetailsParams): Promise<PersonDetails>TMDB Reference: Person Details
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
person_id | number | ✅ | TMDB person identifier. |
language | Language | ❌ | Language for localized results. Defaults to en-US. |
append_to_response | PersonAppendToResponseNamespace | PersonAppendToResponseNamespace[] | ❌ | Subresources to append to the main person details response. |
Returns
A PersonDetails object containing the person's profile.
When append_to_response is used, the response also includes the appended subresource payloads.
Example
import { TMDB } from "@lorenzopant/tmdb";
const tmdb = new TMDB("your-api-key");
const person = await tmdb.people.details({ person_id: 31 });
const withExtras = await tmdb.people.details({
person_id: 31,
append_to_response: ["images", "external_ids", "movie_credits"],
});