Search Movies

Search for movies by their original, translated and alternative titles.

tmdb.search.movies Search for movies by their original, translated and alternative titles..

tmdb.search.movies(options: {
  query: string;
  page?: number;
  language?: string;
  include_adult?: boolean;
  region?: string;
  primary_release_year?: string;
  year?: string
}): Promise<PaginatedResponse<MovieResultItem>>

Parameters

NameTypeRequiredDescription
querystring✅Search query text
include_adultboolean❌Whether to include adult content (default: false)
languagestring❌Language code (default: en-US)
primary_release_yearstring❌Primary release year of the movie
pagenumber❌Page number (default: 1)
regionstring❌Region code (ISO 3166-1)
yearstring❌Release year of the movie

Reference

TMDB - Search Movie

Example

const results = await tmdb.search.movies({ query: "Inception" });

Response

{
  page: 1,
  results: [
    {
      id: 27205,
      title: "Inception",
      original_title: "Inception",
      release_date: "2010-07-15",
      poster_path: "/9gk7adHYeDvHkCSEqAvQNLV5Uge.jpg",
      overview: "...",
      vote_average: 8.4,
      vote_count: 31000,
      genre_ids: [28, 12, 878],
      adult: false
    }
  ],
  total_pages: 1,
  total_results: 1
}

Types

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;
};

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