Person
Search for people by their name and also known as names.
Search for people by their name and also known as names.
async person(params: SearchPersonParams): Promise<PaginatedResponse<PersonResultItem>>TMDB Reference: Search Person
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | ✅ | Search query text. |
include_adult | boolean | ❌ | Include adult (18+) content in results. Defaults to false. |
language | Language | ❌ | Language for localized results. Defaults to en-US. |
page | number | ❌ | Page number for paginated results. Defaults to 1. |
Returns
A PaginatedResponse<PersonResultItem> containing
an array of PersonResultItem objects.
Example
import { TMDB } from "@lorenzopant/tmdb";
const tmdb = new TMDB("your-api-key");
const { results } = await tmdb.search.person({ query: "Christopher Nolan" });
console.log(results);
// [
// { id: 525, name: "Christopher Nolan", known_for_department: "Directing", ... },
// ...
// ]