People

People, filmographies and related content.

Search people

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/people

Find actors and directors by name, citizenship, birth date, or credited role. Filter by the number of movies in their filmography or whether they have award nominations. Each result includes an ID and slug for retrieving the person’s details, filmography, awards, and characters.

Search people › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

q

string · minLength: 1 · maxLength: 120

Match part of a person’s name, ignoring case.

role

string · enum

Only include credits for the selected role: actor or director.

Enum values:

actor

director

born_from

string · pattern: ^\d{4}-\d{2}-\d{2}$

Include people born on or after this date (YYYY-MM-DD).

born_to

string · pattern: ^\d{4}-\d{2}-\d{2}$

Include people born on or before this date (YYYY-MM-DD).

citizenship

string · minLength: 1 · maxLength: 120

Match part of the citizenship value, ignoring case.

min_movies

integer · min: 1 · max: 9007199254740991

Minimum number of distinct movies in the person’s filmography.

has_awards

string · enum

true requires at least one nomination or win; false selects people with neither.

Enum values:

true

false

sort

string · enum

Order results by this field. A leading minus reverses the order.

Enum values:

name

Default: id

Search people › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search people › Responses

The requested data. Examples use illustrative values.

ListPeopleResponse

object[] · required

object · required

Get person details

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/people/{person}

Retrieve a person’s name, portrait, birth details, citizenship, years active, and external links. Filmography statistics include the number of associated movies and their earliest and latest release years. Use the filmography endpoint to retrieve those movies.

Get person details › path Parameters

person

string · minLength: 1 · maxLength: 255 · required

ATM numeric ID or slug.

Get person details › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get person details › Responses

The requested data. Examples use illustrative values.

GetPersonResponse

object · required

Get a person’s filmography

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/people/{person}/movies

List the movies in which a person is credited as an actor or director. Each entry includes the movie’s details, the credited role, and a character name when available. Filter by role, title, release date, genre, language, or company; a person can have separate actor and director entries for the same movie.

Get a person’s filmography › path Parameters

person

string · minLength: 1 · maxLength: 255 · required

ATM numeric ID or slug.

Get a person’s filmography › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

q

string · minLength: 1 · maxLength: 120

Match part of a movie title, ignoring case.

year_from

integer · min: 1800 · max: 2200

Earliest year to include (inclusive).

year_to

integer · min: 1800 · max: 2200

Latest year to include (inclusive).

genre

string · minLength: 1 · maxLength: 120

Filter by genre name, for example Drama. Matching ignores case.

language

string · minLength: 1 · maxLength: 120

Filter by original language, for example en.

release_from

string · pattern: ^\d{4}-\d{2}-\d{2}$

Include movies released on or after this date (YYYY-MM-DD).

release_to

string · pattern: ^\d{4}-\d{2}-\d{2}$

Include movies released on or before this date (YYYY-MM-DD).

company_id

integer · min: 1 · max: 9007199254740991

Only movies associated with this company ID.

role

string · enum

Only include credits for the selected role: actor or director.

Enum values:

actor

director

sort

string · enum

Order results by this field. A leading minus reverses the order.

Enum values:

title

release_date

-release_date

year

-year

Default: id

Get a person’s filmography › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get a person’s filmography › Responses

The requested data. Examples use illustrative values.

GetPersonMoviesResponse

object[] · required

object · required

Get a person’s award history

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/people/{person}/extras/awards

Browse award nominations and wins attributed to a person. Each entry identifies the ceremony, category, movie, and winner status. A person with no award records returns an empty list.

Get a person’s award history › path Parameters

person

string · minLength: 1 · maxLength: 255 · required

ATM numeric ID or slug.

Get a person’s award history › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

Get a person’s award history › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get a person’s award history › Responses

The requested data. Examples use illustrative values.

GetPersonAwardsResponse

object[] · required

object · required

Get a person’s characters

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/people/{person}/extras/characters

Browse explained characters linked to an actor. Each entry includes the character’s name, description, tags, and movie ID. Descriptions may contain spoilers. This list covers characters with explanations; use the filmography endpoint for acting credits. A person with no linked character explanations returns an empty list.

Get a person’s characters › path Parameters

person

string · minLength: 1 · maxLength: 255 · required

ATM numeric ID or slug.

Get a person’s characters › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

Get a person’s characters › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get a person’s characters › Responses

The requested data. Examples use illustrative values.

GetPersonCharactersResponse

object[] · required

object · required

Movies Companies