Recommendations

Get a list of recommended movies for a specific movie.

This is based on the movie's popularity and user ratings.

tmdb.movies.recommendations(params: MovieRecommendationsParams): Promise<MovieRecommendations>;

Parameters

NameTypeRequiredDescription
movie_idnumber✅The ID of the movie.
pagenumber❌Page number of the results. Defaults to 1.
languageLanguageISO6391❌Language for the response

Reference:

https://developer.themoviedb.org/reference/movie-recommendations

Example

const result = await tmdb.movie.recommendations({ movie_id: 550 });

Types

Response Type

export type MovieRecommendations = PaginatedResponse<MovieResultItem>;

export type PaginatedResponse<T> = {
	page: number;
	total_pages: number;
	total_results: number;
	results: T[];
};

export type MovieResultItem = {
	backdrop_path: string;
	id: number;
	title: string;
	original_title: string;
	overview: string;
	poster_path: string;
	media_type: string;
	adult: boolean;
	original_language: string;
	genre_ids: number[];
	popularity: number;
	release_date: string;
	video: boolean;
	vote_average: number;
	vote_count: number;
};

export type MovieRecommendationsParams = {
	movie_id: number;
	page?: number;
	language?: LanguageISO6391;
};

Example Response

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/suaEOtk1N1sgg2MTM7oZd2cfVp3.jpg",
      "id": 680,
      "title": "Pulp Fiction",
      "original_title": "Pulp Fiction",
      "overview": "A burger-loving hit man, his philosophical partner, a drug-addled gangster's moll and a washed-up boxer converge in this sprawling, comedic crime caper. Their adventures unfurl in three stories that ingeniously trip back and forth in time.",
      "poster_path": "/vQWk5YBFWF4bZaofAbv0tShwBvQ.jpg",
      "media_type": "movie",
      "original_language": "en",
      "genre_ids": [
        53,
        80,
        35
      ],
      "popularity": 19.0848,
      "release_date": "1994-09-10",
      "video": false,
      "vote_average": 8.488,
      "vote_count": 28799
    },
    ...
  ],
  "total_pages": 2,
  "total_results": 40
}