Movies

Type definitions for movie details, appended data, and query parameters.

These types represent the full movie domain — details, appended sub-resources, and query parameters.

`MovieDetails`

The complete representation of a movie as returned by movies.details().

Prop

Type

`MovieDetailsWithAppends<T>`

Extends MovieDetails with one or more appended sub-resources. T is a readonly array of MovieAppendToResponseNamespace keys.

// Example: fetch movie with credits and videos appended
const movie: MovieDetailsWithAppends<["credits", "videos"]> = await tmdb.movies.details({
	movie_id: 550,
	append_to_response: ["credits", "videos"],
});

`MovieAppendToResponseNamespace`

Union of all valid keys that can be passed to append_to_response.

type MovieAppendToResponseNamespace =
	| "alternative_titles"
	| "changes"
	| "credits"
	| "external_ids"
	| "images"
	| "keywords"
	| "recommendations"
	| "release_dates"
	| "reviews"
	| "similar"
	| "translations"
	| "videos";

Additional Resources

Other types returned by movies endpoints.

`MovieAlternativeTitles`

Prop

Type

`MovieChanges`

Alias for Changes. Returns the change history for a movie.

`MovieCredits`

Prop

Type

`MovieExternalIDs`

Prop

Type

`MovieImages`

Prop

Type

`MovieKeywords`

Prop

Type

`MovieRecommendations`

A PaginatedResponse<MovieResultItem> of recommended movies.

See MovieResultItem.

`MovieReleaseDates`

Prop

Type

`MovieReleaseDateResult`

Prop

Type

`MovieReleaseDate`

Prop

Type

See ReleaseType.

`MovieReviews`

A PaginatedResponse<Review> of user reviews.

`MovieSimilar`

A PaginatedResponse<MovieResultItem> of similar movies.

See MovieResultItem.

`MovieTranslations`

Prop

Type

`MovieTranslationItem`

Extends Translation with a data field.

Prop

Type

`MovieTranslationData`

Prop

Type

`MovieVideos`

Prop

Type

Parameters

`MovieDetailsParams`

Prop

Type

`MovieListParams`

Alias for TMDBQueryParams. Used by popular, top rated, now playing, and upcoming list endpoints.

`MovieAlternativeTitlesParams`

Prop

Type

`MovieCreditsParams`

Prop

Type

`MovieChangesParams`

Prop

Type

`MovieImagesParams`

Prop

Type

`MovieRecommendationsParams` / `MovieSimilarParams`

Prop

Type

`MovieReviewsParams`

Same shape as MovieRecommendationsParams.

`MovieVideosParams`

Prop

Type

`MovieBaseParam`

Prop

Type

Find

Type definitions for finding TMDB resources by external IDs.

TV Series

Type definitions for TV series details, appended data, and query parameters.