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

# Find by ID

> This endpoint allows you to find data by external IDs.



## OpenAPI

````yaml get /find/{{external_id}}
openapi: 3.0.3
info:
  title: TMDB API DOCS
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: >-
      This section contains endpoints that let you create authentication
      sessions for TMDB Guests and User accounts.
  - name: Account
    description: >-
      This section contains endpoints that let you access and sync with TMDB
      user account information.
  - name: Certifications
    description: >-
      This section contains endpoints that provide an up-to-date list of the
      officially supported movies and TV show certifications on TMDB.
  - name: Changes
    description: >-
      This section contains endpoints that let you fetch the list of Movie IDs,
      People IDs, and TV show IDs that have been changed in the past 24 hours.
  - name: Collections
    description: >-
      This collection contains endpoints that let you fetch movie collection
      details.
  - name: Discover
    description: >-
      This section contains endpoints that let you search for movies and TV
      shows, using sorts and filters.
  - name: Configuration
    description: This section contains endpoints that let you query the API configuration.
  - name: Movies
    description: >-
      This section contains endpoints that let you fetch information about the
      movie resource.
  - name: Companies
    description: >-
      This section contains endpoints that fetch information about a movie
      production company.
  - name: Credits
    description: This section contains endpoint for credit details.
  - name: Find
    description: This section contains endpoints that let you find movie or TV data.
  - name: Genres
    description: This section contain endpoints that let you get movie and TV genres.
  - name: Search
    description: This section contains endpoints that let you search through TMDB
  - name: Keywords
    description: This section contains endpoints for keyword information in TMDB
  - name: Movie Lists
    description: >-
      This section contains endpoints that let you fetch information about list
      of movies on TMDB
  - name: Networks
    description: >-
      This section contains endpoints that let you get information about the
      streaming networks.
  - name: People Lists
    description: This section contains endpoints of list of people.
  - name: People
    description: >-
      This section contains endpoints that let you get information about a
      person.
  - name: Reviews
    description: This section contains endpoints for movie or TV reviews.
  - name: Trending
    description: This section contains endpoints for trending movies, TV shows, and people.
  - name: TV Series List
    description: This section contains endpoints for listing TV series.
  - name: TV Series
    description: >-
      This section contains endpoints that let you get information for a TV
      series by ID
  - name: TV Seasons
    description: This section contains endpoints for TV show seasons.
  - name: TV Episodes
    description: >-
      This section contains endpoints that let you query information about a TV
      episode.
  - name: TV Episode groups
    description: This section contains endpoints for TV Episode information
  - name: Watch providers
    description: >-
      This section contains endpoints that let you get information about watch
      providers.
paths:
  /find/{{external_id}}:
    parameters:
      - name: external_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - Find
      summary: Find by ID
      description: This endpoint allows you to find data by external IDs.
      operationId: findById
      parameters:
        - name: external_source
          in: query
          schema:
            type: string
            example: imdb_id
        - name: language
          in: query
          schema:
            type: string
            example: string
      responses:
        '200':
          description: Find by ID
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=1037
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Tue, 17 Dec 2024 14:40:56 GMT
            ETag:
              schema:
                type: string
                example: W/"536b90e8b3180aeb3b6c7f7cbbfb019e"
            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 08f45c153a856ff7955174d0e6f60744.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: 2ZDxqWtsiPmKBeb0lUza2mr2bkrXNNzkvzzze-1VKtjgNs0vYL24Qg==
            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: '24847'
            x-memc-expires:
              schema:
                type: string
                example: '1037'
            x-memc-key:
              schema:
                type: string
                example: 9ebe8654d4645188433408719407f556
          content:
            application/json:
              schema:
                type: object
                properties:
                  movie_results:
                    type: array
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                          example: false
                        backdrop_path:
                          type: string
                          example: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 28
                          example:
                            - 28
                            - 12
                            - 36
                        id:
                          type: number
                          example: 558449
                        media_type:
                          type: string
                          example: movie
                        original_language:
                          type: string
                          example: en
                        original_title:
                          type: string
                          example: Gladiator II
                        overview:
                          type: string
                          example: >-
                            Years after witnessing the death of the revered hero
                            Maximus at the hands of his uncle, Lucius is forced
                            to enter the Colosseum after his home is conquered
                            by the tyrannical Emperors who now lead Rome with an
                            iron fist. With rage in his heart and the future of
                            the Empire at stake, Lucius must look to his past to
                            find strength and honor to return the glory of Rome
                            to its people.
                        popularity:
                          type: number
                          example: 900.089
                        poster_path:
                          type: string
                          example: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg
                        release_date:
                          type: string
                          example: '2024-11-05'
                        title:
                          type: string
                          example: Gladiator II
                        video:
                          type: boolean
                          example: false
                        vote_average:
                          type: number
                          example: 6.7
                        vote_count:
                          type: number
                          example: 1106
                    example:
                      - adult: false
                        backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg
                        genre_ids:
                          - 28
                          - 12
                          - 36
                        id: 558449
                        media_type: movie
                        original_language: en
                        original_title: Gladiator II
                        overview: >-
                          Years after witnessing the death of the revered hero
                          Maximus at the hands of his uncle, Lucius is forced to
                          enter the Colosseum after his home is conquered by the
                          tyrannical Emperors who now lead Rome with an iron
                          fist. With rage in his heart and the future of the
                          Empire at stake, Lucius must look to his past to find
                          strength and honor to return the glory of Rome to its
                          people.
                        popularity: 900.089
                        poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg
                        release_date: '2024-11-05'
                        title: Gladiator II
                        video: false
                        vote_average: 6.7
                        vote_count: 1106
                  person_results:
                    type: array
                    items: {}
                    example: []
                  tv_episode_results:
                    type: array
                    items: {}
                    example: []
                  tv_results:
                    type: array
                    items: {}
                    example: []
                  tv_season_results:
                    type: array
                    items: {}
                    example: []
              examples:
                Find by ID:
                  value:
                    movie_results:
                      - adult: false
                        backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg
                        genre_ids:
                          - 28
                          - 12
                          - 36
                        id: 558449
                        media_type: movie
                        original_language: en
                        original_title: Gladiator II
                        overview: >-
                          Years after witnessing the death of the revered hero
                          Maximus at the hands of his uncle, Lucius is forced to
                          enter the Colosseum after his home is conquered by the
                          tyrannical Emperors who now lead Rome with an iron
                          fist. With rage in his heart and the future of the
                          Empire at stake, Lucius must look to his past to find
                          strength and honor to return the glory of Rome to its
                          people.
                        popularity: 900.089
                        poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg
                        release_date: '2024-11-05'
                        title: Gladiator II
                        video: false
                        vote_average: 6.7
                        vote_count: 1106
                    person_results: []
                    tv_episode_results: []
                    tv_results: []
                    tv_season_results: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````