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