Search Collections

Search for collections by their original, translated and alternative names.

tmdb.search.collections(options: {
  query: string;
  page?: number;
  language?: string;
  include_adult?: boolean;
  region?: string;
}): Promise<PaginatedResponse<SearchCollectionItem>>

Parameters

NameTypeRequiredDescription
querystring✅Search query text
include_adultboolean❌Whether to include adult content (default: false)
languagestring❌Language code (default: en-US)
pagenumber❌Page number (default: 1)
regionstring❌Region code (ISO 3166-1)

Reference

TMDB - Search Collection

Example

const results = await tmdb.search.collections({ query: "Avengers" });

Response

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/2UNUv4NJdC36E5myDHACBJ99EwL.jpg",
      "id": 86311,
      "name": "The Avengers Collection",
      "original_language": "en",
      "original_name": "The Avengers Collection",
      "overview": "A superhero film series produced by Marvel Studios based on the Marvel Comics superhero team of the same name, and part of the Marvel Cinematic Universe (MCU).  The series features an ensemble cast from the Marvel Cinematic Universe series films, as they join forces for the peacekeeping organization S.H.I.E.L.D. led by Nick Fury.",
      "poster_path": "/yFSIUVTCvgYrpalUktulvk3Gi5Y.jpg"
    },
    {
      "adult": false,
      "backdrop_path": "/AvnqpRwlEaYNVL6wzC4RN94EdSd.jpg",
      "id": 531241,
      "name": "Spider-Man (MCU) Collection",
      "original_language": "en",
      "original_name": "Spider-Man (MCU) Collection",
      "overview": "A collection of films following Peter Parker as he navigates adolescence while taking on the responsibilities of being Spider-Man in a world filled with superheroes. As Peter faces increasingly complex threats, he must confront the consequences of his choices and learn what it truly means to be a hero in a larger universe.",
      "poster_path": "/yeba3Y820OjApZO9aJevDsNeMEd.jpg"
    }
  ],
  "total_pages": 1,
  "total_results": 6
}

Types

type SearchCollectionItem = {
    adult: boolean;
    backdrop_path: string;
    id: number;
    name: string;
    original_name: string;
    original_language: string;
    overview: string;
    poster_path: string;
};

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