Reviews

Get the users reviews for a movie.

tmdb.movies.reviews(params: MovieReviewsParams): Promise<MovieReviews>;

Parameters

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

Reference:

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

Example

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

Types

Response Type

export type MovieReviews = PaginatedResponse<MovieReview>;

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

export type MovieReview = {
	author: string;
	author_details: MovieReviewAuthorDetails;
	content: string;
	created_at: string;
	id: string;
	updated_at: string;
	url: string;
};

export type MovieReviewAuthorDetails = {
	name: string;
	username: string;
	avatar_path?: string;
	rating?: number;
};

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

Example Response

{
  "id": 550,
  "page": 1,
  "results": [
    {
      "author": "Goddard",
      "author_details": {
        "name": "",
        "username": "Goddard",
        "avatar_path": null,
        "rating": null
      },
      "content": "Pretty awesome movie.  It shows what one crazy person can convince other crazy people to do.  Everyone needs something to believe in.  I recommend Jesus Christ, but they want Tyler Durden.",
      "created_at": "2018-06-09T17:51:53.359Z",
      "id": "5b1c13b9c3a36848f2026384",
      "updated_at": "2021-06-23T15:58:09.421Z",
      "url": "https://www.themoviedb.org/review/5b1c13b9c3a36848f2026384"
    },
    {
      "author": "Brett Pascoe",
      "author_details": {
        "name": "Brett Pascoe",
        "username": "SneekyNuts",
        "avatar_path": null,
        "rating": 9
      },
      "content": "In my top 5 of all time favourite movies. Great story line and a movie you can watch over and over again.",
      "created_at": "2018-07-05T13:22:41.754Z",
      "id": "5b3e1ba1925141144c007f17",
      "updated_at": "2021-06-23T15:58:10.199Z",
      "url": "https://www.themoviedb.org/review/5b3e1ba1925141144c007f17"
    },
    ...
  ],
  "total_pages": 1,
  "total_results": 10
}