> ## Documentation Index
> Fetch the complete documentation index at: https://starlight.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi Search

> This endpoint allows you to multi-search in one request. It retrieves multiple media types including TV shows, movies, and people in a single request.



## OpenAPI

````yaml api-reference/openapi.yaml get /3/search/multi
openapi: 3.0.3
info:
  title: The Movie Database API
  description: >-
    Welcome to the third version of The Movie Database (TMDB) API. Our API
    provides you with vast access to a range of movies, TV shows, actor
    information, and images.


    With the TMDB API, you can easily integrate any of these functionalities in
    your application.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
  - url: Collection
security:
  - bearerAuth: []
tags:
  - name: Validate Key
  - name: Authentication
  - name: Guest Sessions
  - name: Configuration
  - name: Account
  - name: Search
  - name: Discover
  - name: Find
  - name: Keyword
  - name: Lists
  - name: V3 vs V4
    description: >-
      There is version 4 (v4) for our list API. It contains several advanced
      improvements that differentiate it from the version 3 (v3) list. Although
      v3 lists will continue to work, you can only access these features if you
      switch to v4 lists.


      Some of the new improvements you can access on v4 lists include:


      - You can Import "unlimited" items in a single request
          
      - You can use mixed-type (movie and TV) lists
          
      - You can use private lists
          
      - You can add and use comments per item
          
      - There are more sort options
          
      - They are faster
          

      Check the v4 [documentation
      ](https://developer.themoviedb.org/v4/docs/getting-started) for more
      information.  
  - name: Collections
  - name: Companies
  - name: Networks
  - name: Trending
  - name: Movies
  - name: Movie Lists
  - name: TV Series
  - name: TV Series Lists
  - name: TV Seasons
  - name: TV Providers
  - name: TV Episode Groups
  - name: Watch Providers
  - name: People
  - name: People List
  - name: Genre
  - name: Changes
  - name: Credits
  - name: Certifications
paths:
  /3/search/multi:
    get:
      tags:
        - Search
      summary: Multi Search
      description: >-
        This endpoint allows you to multi-search in one request. It retrieves
        multiple media types including TV shows, movies, and people in a single
        request.
      operationId: multiSearch
      parameters:
        - name: query
          in: query
          schema:
            type: string
            example: Squid Game
          description: >-
            This represents the Tv shows, movies, or people you want to look
            for.
        - name: page
          in: query
          schema:
            type: string
            example: '1'
          description: This represents the page number.
      responses:
        '200':
          description: Multi search
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=4579
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sat, 28 Dec 2024 13:10:56 GMT
            ETag:
              schema:
                type: string
                example: W/"32a603a4eb4dcdde54e74038f92f9b9d"
            Server:
              schema:
                type: string
                example: openresty
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 b471d3775e81a9be536b52b99f39452a.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: hgJwYbdORaKf_4qz_62oZw95VPNqdpHsmOUN5rIpMHJYKcgXF4eEZg==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: IAD89-C3
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: HIT
            x-memc-age:
              schema:
                type: string
                example: '20836'
            x-memc-expires:
              schema:
                type: string
                example: '4579'
            x-memc-key:
              schema:
                type: string
                example: a4c93593f98889d67538e7387f46d8e7
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: number
                    example: 1
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                          example: false
                        backdrop_path:
                          type: string
                          example: /2meX1nMdScFOoV4370rqHWKmXhY.jpg
                        first_air_date:
                          type: string
                          example: '2021-09-17'
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 10759
                          example:
                            - 10759
                            - 9648
                            - 18
                        id:
                          type: number
                          example: 93405
                        media_type:
                          type: string
                          example: tv
                        name:
                          type: string
                          example: Squid Game
                        origin_country:
                          type: array
                          items:
                            type: string
                            example: KR
                          example:
                            - KR
                        original_language:
                          type: string
                          example: ko
                        original_name:
                          type: string
                          example: 오징어 게임
                        original_title:
                          type: string
                          example: 'Making Squid Game: The Challenge'
                        overview:
                          type: string
                          example: >-
                            Hundreds of cash-strapped players accept a strange
                            invitation to compete in children's games. Inside, a
                            tempting prize awaits — with deadly high stakes.
                        popularity:
                          type: number
                          example: 1601.261
                        poster_path:
                          type: string
                          example: /dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg
                        release_date:
                          type: string
                          example: '2023-12-07'
                        title:
                          type: string
                          example: 'Making Squid Game: The Challenge'
                        video:
                          type: boolean
                          example: false
                        vote_average:
                          type: number
                          example: 7.835
                        vote_count:
                          type: number
                          example: 14204
                    example:
                      - adult: false
                        backdrop_path: /2meX1nMdScFOoV4370rqHWKmXhY.jpg
                        first_air_date: '2021-09-17'
                        genre_ids:
                          - 10759
                          - 9648
                          - 18
                        id: 93405
                        media_type: tv
                        name: Squid Game
                        origin_country:
                          - KR
                        original_language: ko
                        original_name: 오징어 게임
                        overview: >-
                          Hundreds of cash-strapped players accept a strange
                          invitation to compete in children's games. Inside, a
                          tempting prize awaits — with deadly high stakes.
                        popularity: 1601.261
                        poster_path: /dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg
                        vote_average: 7.835
                        vote_count: 14204
                      - adult: false
                        backdrop_path: /fQsIJQxE1D0Y0NpWSKwo489y5px.jpg
                        first_air_date: '2023-11-22'
                        genre_ids:
                          - 10764
                        id: 204082
                        media_type: tv
                        name: 'Squid Game: The Challenge'
                        origin_country:
                          - GB
                        original_language: en
                        original_name: 'Squid Game: The Challenge'
                        overview: >-
                          In this reality competition show inspired by "Squid
                          Game," 456 players put their skills to the ultimate
                          test for a life-changing $4.56 million prize.
                        popularity: 492.883
                        poster_path: /eAjXAgdjPMZH9Ugub7XYPowFoS1.jpg
                        vote_average: 6.319
                        vote_count: 262
                      - adult: false
                        backdrop_path: /lb2WCbppZ6iHfokg7ccmgjKPKNh.jpg
                        genre_ids:
                          - 99
                        id: 1214667
                        media_type: movie
                        original_language: en
                        original_title: 'Making Squid Game: The Challenge'
                        overview: >-
                          Go behind the scenes and witness how the "Squid Game"
                          - inspired reality show transformed from a scripted
                          drama to a cutthroat, nail-biting competition.
                        popularity: 27.465
                        poster_path: /lUb97EhBhNBfQ9wmy8YMbiNLtGh.jpg
                        release_date: '2023-12-07'
                        title: 'Making Squid Game: The Challenge'
                        video: false
                        vote_average: 5.1
                        vote_count: 10
                      - adult: false
                        backdrop_path: /lu4khHVh8ZF9AbaxW26pp4yLubb.jpg
                        genre_ids: []
                        id: 1408248
                        media_type: movie
                        original_language: ko
                        original_title: '오징어 게임: 벽난로'
                        overview: >-
                          Come share a toast in the Front Man's lair — but tread
                          carefully, for you’re playing with fire.
                        popularity: 1.4
                        poster_path: /wzWcY5MMJaezP4niGmmpdvluvaZ.jpg
                        release_date: '2024-12-12'
                        title: 'Squid Game: Fireplace'
                        video: false
                        vote_average: 0
                        vote_count: 0
                      - adult: false
                        backdrop_path: /qqId1R2RUWSm98I3UqrEN7hP548.jpg
                        genre_ids:
                          - 12
                          - 14
                        id: 1388071
                        media_type: movie
                        original_language: en
                        original_title: 'Squid Game 3: The Maclanky'
                        overview: >-
                          Sir Knight and the Gray Wizard set off to end the
                          terror of the Squid People once and for all.
                        popularity: 3.812
                        poster_path: /e02t4nWmFRjGsUmxIbnRPSnkhzh.jpg
                        release_date: '2024-07-13'
                        title: 'Squid Game 3: The Maclanky'
                        video: false
                        vote_average: 7
                        vote_count: 1
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 5
              examples:
                Multi search:
                  value:
                    page: 1
                    results:
                      - adult: false
                        backdrop_path: /2meX1nMdScFOoV4370rqHWKmXhY.jpg
                        first_air_date: '2021-09-17'
                        genre_ids:
                          - 10759
                          - 9648
                          - 18
                        id: 93405
                        media_type: tv
                        name: Squid Game
                        origin_country:
                          - KR
                        original_language: ko
                        original_name: 오징어 게임
                        overview: >-
                          Hundreds of cash-strapped players accept a strange
                          invitation to compete in children's games. Inside, a
                          tempting prize awaits — with deadly high stakes.
                        popularity: 1601.261
                        poster_path: /dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg
                        vote_average: 7.835
                        vote_count: 14204
                      - adult: false
                        backdrop_path: /fQsIJQxE1D0Y0NpWSKwo489y5px.jpg
                        first_air_date: '2023-11-22'
                        genre_ids:
                          - 10764
                        id: 204082
                        media_type: tv
                        name: 'Squid Game: The Challenge'
                        origin_country:
                          - GB
                        original_language: en
                        original_name: 'Squid Game: The Challenge'
                        overview: >-
                          In this reality competition show inspired by "Squid
                          Game," 456 players put their skills to the ultimate
                          test for a life-changing $4.56 million prize.
                        popularity: 492.883
                        poster_path: /eAjXAgdjPMZH9Ugub7XYPowFoS1.jpg
                        vote_average: 6.319
                        vote_count: 262
                      - adult: false
                        backdrop_path: /lb2WCbppZ6iHfokg7ccmgjKPKNh.jpg
                        genre_ids:
                          - 99
                        id: 1214667
                        media_type: movie
                        original_language: en
                        original_title: 'Making Squid Game: The Challenge'
                        overview: >-
                          Go behind the scenes and witness how the "Squid Game"
                          - inspired reality show transformed from a scripted
                          drama to a cutthroat, nail-biting competition.
                        popularity: 27.465
                        poster_path: /lUb97EhBhNBfQ9wmy8YMbiNLtGh.jpg
                        release_date: '2023-12-07'
                        title: 'Making Squid Game: The Challenge'
                        video: false
                        vote_average: 5.1
                        vote_count: 10
                      - adult: false
                        backdrop_path: /lu4khHVh8ZF9AbaxW26pp4yLubb.jpg
                        genre_ids: []
                        id: 1408248
                        media_type: movie
                        original_language: ko
                        original_title: '오징어 게임: 벽난로'
                        overview: >-
                          Come share a toast in the Front Man's lair — but tread
                          carefully, for you’re playing with fire.
                        popularity: 1.4
                        poster_path: /wzWcY5MMJaezP4niGmmpdvluvaZ.jpg
                        release_date: '2024-12-12'
                        title: 'Squid Game: Fireplace'
                        video: false
                        vote_average: 0
                        vote_count: 0
                      - adult: false
                        backdrop_path: /qqId1R2RUWSm98I3UqrEN7hP548.jpg
                        genre_ids:
                          - 12
                          - 14
                        id: 1388071
                        media_type: movie
                        original_language: en
                        original_title: 'Squid Game 3: The Maclanky'
                        overview: >-
                          Sir Knight and the Gray Wizard set off to end the
                          terror of the Squid People once and for all.
                        popularity: 3.812
                        poster_path: /e02t4nWmFRjGsUmxIbnRPSnkhzh.jpg
                        release_date: '2024-07-13'
                        title: 'Squid Game 3: The Maclanky'
                        video: false
                        vote_average: 7
                        vote_count: 1
                    total_pages: 1
                    total_results: 5
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````