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

# Find by external ID

> This endpoint is used to find a movie, tv show, etc. by external ID's.



## OpenAPI

````yaml api-reference/openapi.yaml get /3/find/ScreamMovies
openapi: 3.0.3
info:
  title: Endpoints
  description: This section contains all the endpoints used in the documentation.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: This section contains all endpoints used for authentication
  - name: Accounts
    description: This section contains account-specific endpoints.
  - name: Favorites
    description: >-
      This section contains all endpoints that allow a TMDB account to add
      movies, TV Shows, episodes to favorites, and also to get a list of
      favorites for the account.
  - name: Movies
    description: >-
      This section contains an endpoint to add a movie to favorites, and another
      to get a list of favorite movies for a TMDB account.
  - name: TV shows
    description: >-
      This section contains an endpoint to get the favorite TV shows for an
      account.
  - name: Watchlist
    description: >-
      This section contains all endpoints that allow a TMDB account to add
      movies, TV Shows to watchlist, and also to get a list of watchlist for the
      account.
  - name: Movies1
    description: >-
      This section contains an endpoint that allows a TMDB account to add a
      movie to watchlist, and another to get the movies in a watchlist.
  - name: TV shows1
    description: >-
      This section contains an endpoint used to get TV shows in an account's
      watchlist.
  - name: Ratings
    description: >-
      This section contains endpoints used to get all movies, TV Shows, and
      episodes rated by a TMDB account.
  - name: Movies12
    description: >-
      This section contains an endpoint used to get a list of movies rated by a
      TMDB account.
  - name: TV shows12
    description: >-
      This section contains an endpoint used to get a list of TV shows rated by
      a TMDB account.
  - name: Episodes
    description: >-
      This section contains an endpoint used to get a list of episodes rated by
      a TMDB account.
  - name: Lists
    description: Endpoints for a TMDB account lists.
  - name: Guest sessions
    description: This section contains all endpoints accessible by a guest session.
  - name: Movies
    description: For movies.
  - name: TV episodes
    description: >-
      This section contains all endpoints used to retrieve data for all TV
      episodes.
  - name: TV seasons
    description: >-
      This section contains all endpoints used to retrieve data for all TV
      seasons.
  - name: TV series
    description: >-
      This section contains all endpoints used to retrieve data for all TV
      series.
  - name: TV series lists
    description: This section contains all endpoints used to list TV series.
  - name: TV episode groups
    description: This section contains an endpoint used to retrieve data for TV episodes.
  - name: Watch providers
    description: Get available regions.
  - name: People
    description: About people lists.
  - name: Companies
    description: >-
      This section contains all endpoints used to retrieve data for supported
      companies.
  - name: Discover
    description: This section contains all endpoints used to discover movies and TV shows.
  - name: Recent changes
    description: >-
      This section contains all endpoints used to get recent changes in the TMDB
      database.
  - name: Credit
    description: This section contains an endpoint used to retrieve movie credits.
  - name: Certifications
    description: >-
      This section contains all endpoints used to get certification for movies
      and TV shows.
  - name: Collections
    description: This section contains all endpoints used to retrieve data for collections
  - name: Configuration
    description: >-
      This section contains all endpoints used to retrieve data on TMDB's
      configurations.
  - name: Find
    description: >-
      This section contains an endpoint used to search the TMDB database by
      External ID.
  - name: Genres
    description: This section contains endpoints related to genres.
  - name: Keywords
    description: >-
      This section contains an endpoint used to get keywords in the database by
      an ID.
  - name: Movie lists
    description: >-
      This section contains all endpoints used to retrieve movies by multiple
      search filters.
  - name: Networks
    description: For network endpoints.
  - name: Reviews
    description: For reviews endpoints.
  - name: Search
    description: For search endpoints.
  - name: Trending
    description: For trending videos.
paths:
  /3/find/ScreamMovies:
    get:
      tags:
        - Find
      summary: Find by external ID
      description: This endpoint is used to find a movie, tv show, etc. by external ID's.
      operationId: findByExternalId
      parameters:
        - name: external_source
          in: query
          schema:
            type: string
            example: facebook_id
          description: The source of the external ID
      requestBody:
        content:
          application/json:
            examples:
              Find by external ID:
                value: ''
      responses:
        '200':
          description: New Request
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=21036
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Thu, 26 Dec 2024 14:00:10 GMT
            ETag:
              schema:
                type: string
                example: W/"80a41302d700e6430dea7aa376abcc5e"
            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 58a361324cd2b1576fcc05c5471b9b12.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: '-N9Vxjq8V4CHcDY4hJfF_wFIwDVugbAhnHzX0gR9Mh-B9CVa8ohjTQ=='
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: AMS54-C1
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: HIT
            x-memc-age:
              schema:
                type: string
                example: '5646'
            x-memc-expires:
              schema:
                type: string
                example: '21036'
            x-memc-key:
              schema:
                type: string
                example: 04b1f8d7afdeb2038a12a5916fc039f8
          content:
            application/json:
              schema:
                type: object
                properties:
                  movie_results:
                    type: array
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                          example: false
                        backdrop_path:
                          type: string
                          nullable: true
                          example: null
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 27
                          example:
                            - 27
                            - 9648
                            - 53
                        id:
                          type: number
                          example: 1159559
                        media_type:
                          type: string
                          example: movie
                        original_language:
                          type: string
                          example: en
                        original_title:
                          type: string
                          example: Scream 7
                        overview:
                          type: string
                          example: >-
                            The seventh installment in the 'Scream' franchise.
                            Plot TBA.
                        popularity:
                          type: number
                          example: 8.827
                        poster_path:
                          type: string
                          example: /ki5azTlJJUQYKi1Aj2HHPmU4H8Z.jpg
                        release_date:
                          type: string
                          example: '2026-02-25'
                        title:
                          type: string
                          example: Scream 7
                        video:
                          type: boolean
                          example: false
                        vote_average:
                          type: number
                          example: 0
                        vote_count:
                          type: number
                          example: 0
                    example:
                      - adult: false
                        backdrop_path: null
                        genre_ids:
                          - 27
                          - 9648
                          - 53
                        id: 1159559
                        media_type: movie
                        original_language: en
                        original_title: Scream 7
                        overview: >-
                          The seventh installment in the 'Scream' franchise.
                          Plot TBA.
                        popularity: 8.827
                        poster_path: /ki5azTlJJUQYKi1Aj2HHPmU4H8Z.jpg
                        release_date: '2026-02-25'
                        title: Scream 7
                        video: false
                        vote_average: 0
                        vote_count: 0
                      - adult: false
                        backdrop_path: /ifUfE79O1raUwbaQRIB7XnFz5ZC.jpg
                        genre_ids:
                          - 27
                          - 9648
                          - 53
                        id: 646385
                        media_type: movie
                        original_language: en
                        original_title: Scream
                        overview: >-
                          Twenty-five years after a streak of brutal murders
                          shocked the quiet town of Woodsboro, a new killer has
                          donned the Ghostface mask and begins targeting a group
                          of teenagers to resurrect secrets from the town’s
                          deadly past.
                        popularity: 72.296
                        poster_path: /1m3W6cpgwuIyjtg5nSnPx7yFkXW.jpg
                        release_date: '2022-01-12'
                        title: Scream
                        video: false
                        vote_average: 6.7
                        vote_count: 3318
                      - adult: false
                        backdrop_path: /h04s7VIbMWxTa4BBhwdg4CR6vNc.jpg
                        genre_ids:
                          - 27
                          - 80
                          - 53
                        id: 934433
                        media_type: movie
                        original_language: en
                        original_title: Scream VI
                        overview: >-
                          Following the latest Ghostface killings, the four
                          survivors leave Woodsboro behind and start a fresh
                          chapter.
                        popularity: 129.887
                        poster_path: /wDWwtvkRRlgTiUr6TyLSMX8FCuZ.jpg
                        release_date: '2023-03-08'
                        title: Scream VI
                        video: false
                        vote_average: 7
                        vote_count: 2643
                  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:
                New Request:
                  value:
                    movie_results:
                      - adult: false
                        backdrop_path: null
                        genre_ids:
                          - 27
                          - 9648
                          - 53
                        id: 1159559
                        media_type: movie
                        original_language: en
                        original_title: Scream 7
                        overview: >-
                          The seventh installment in the 'Scream' franchise.
                          Plot TBA.
                        popularity: 8.827
                        poster_path: /ki5azTlJJUQYKi1Aj2HHPmU4H8Z.jpg
                        release_date: '2026-02-25'
                        title: Scream 7
                        video: false
                        vote_average: 0
                        vote_count: 0
                      - adult: false
                        backdrop_path: /ifUfE79O1raUwbaQRIB7XnFz5ZC.jpg
                        genre_ids:
                          - 27
                          - 9648
                          - 53
                        id: 646385
                        media_type: movie
                        original_language: en
                        original_title: Scream
                        overview: >-
                          Twenty-five years after a streak of brutal murders
                          shocked the quiet town of Woodsboro, a new killer has
                          donned the Ghostface mask and begins targeting a group
                          of teenagers to resurrect secrets from the town’s
                          deadly past.
                        popularity: 72.296
                        poster_path: /1m3W6cpgwuIyjtg5nSnPx7yFkXW.jpg
                        release_date: '2022-01-12'
                        title: Scream
                        video: false
                        vote_average: 6.7
                        vote_count: 3318
                      - adult: false
                        backdrop_path: /h04s7VIbMWxTa4BBhwdg4CR6vNc.jpg
                        genre_ids:
                          - 27
                          - 80
                          - 53
                        id: 934433
                        media_type: movie
                        original_language: en
                        original_title: Scream VI
                        overview: >-
                          Following the latest Ghostface killings, the four
                          survivors leave Woodsboro behind and start a fresh
                          chapter.
                        popularity: 129.887
                        poster_path: /wDWwtvkRRlgTiUr6TyLSMX8FCuZ.jpg
                        release_date: '2023-03-08'
                        title: Scream VI
                        video: false
                        vote_average: 7
                        vote_count: 2643
                    person_results: []
                    tv_episode_results: []
                    tv_results: []
                    tv_season_results: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````