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

# Find by ID

> This endpoint find data by external ID's.


| Source | Movies | TV Shows | TV Seasons | TV Episodes | People |
| - | - | - | - | - | - |
| IMDb | ✅ | ✅ | | ✅ | ✅ |
| Facebook | ✅ | ✅ | | | ✅ |
| Instagram | ✅ | ✅ | | | ✅ |
| TheTVDB | | ✅ | ✅ | ✅ | |
| TikTok | ✅ | ✅ | | | ✅ |
| Twitter | ✅ | ✅ | | | ✅ |
| Wikidata | ✅ | ✅ | ✅ | ✅ | ✅ |
| YouTube | ✅ | ✅ | | | ✅ |


## OpenAPI

````yaml get /find/{external_id}
openapi: 3.0.3
info:
  title: TMDB API DOCUMENTATION
  description: >-
    The Movie Database is an API that provides comprehensive movie, TV show, and
    celebrity data. TMDB offers APIs that developers use to access and integrate
    its data into applications, websites, or services.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Endpoints for managing authentication, including login and user sessions.
  - name: Account
    description: Endpoints for managing user accounts, such as profiles and settings.
  - name: Certification
    description: Endpoints for retrieving and managing certification data.
  - name: Changes
    description: Endpoints for tracking changes and updates across the system.
  - name: Collection
    description: Endpoints for managing and accessing user collections.
  - name: Companies
    description: Endpoints for retrieving and managing company-related data.
  - name: Configuration
    description: Endpoints for accessing and updating system configuration settings.
  - name: Credits
    description: Endpoints for retrieving credit information related to movies or shows.
  - name: Discover
    description: Endpoints for discovering content based on filters and criteria.
  - name: Find
    description: Endpoints for locating specific items or entities in the database.
  - name: Genres
    description: Endpoints for retrieving and managing genres for categorization.
  - name: Guest Sessions
    description: Endpoints for creating and managing guest user sessions.
  - name: Keywords
    description: Endpoints for managing and searching content using keywords.
  - name: Lists
    description: Endpoints for creating and managing user-generated lists.
  - name: Movie Lists
    description: Endpoints for retrieving and managing lists of movies.
  - name: Movies
    description: Endpoints for retrieving detailed information about movies.
  - name: Networks
    description: Endpoints for retrieving and managing network-related data.
  - name: People Lists
    description: Endpoints for retrieving and managing lists of people in the system.
  - name: People
    description: Endpoints for retrieving information about actors, directors, and others.
  - name: Search
    description: Endpoints for performing searches across multiple categories.
  - name: Reviews
    description: Endpoints for managing and displaying reviews from users.
  - name: Trending
    description: Endpoints for retrieving trending content based on popularity.
  - name: TV Series Lists
    description: Endpoints for retrieving and managing lists of TV series.
  - name: TV Series
    description: Endpoints for retrieving detailed information about TV series.
  - name: TV Seasons
    description: Endpoints for retrieving and managing information about TV seasons.
  - name: TV Episodes
    description: Endpoints for retrieving and managing information about TV episodes.
  - name: TV Episode Groups
    description: Endpoints for managing groups of TV episodes organized by criteria.
  - name: Watch Providers
    description: >-
      Endpoints for retrieving availability information from streaming
      providers.
  - name: Auth
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
  - name: Lists
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
paths:
  /find/{external_id}:
    get:
      tags:
        - Find
      summary: Find by ID
      description: |
        This endpoint find data by external ID's.
      operationId: findbyID
      parameters:
        - name: external_id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/string'
          description: The external ID to find the movie
        - name: external_source
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/string'
          description: The external source of the movie
        - name: language
          in: query
          required: false
          description: Defaults to en-US
          schema:
            type: string
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  movie_results:
                    type: array
                    description: >-
                      Contains an array of movie-related results that match the
                      search criteria or ID provided.
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                        backdrop_path:
                          type: string
                        id:
                          type: integer
                        title:
                          type: string
                        original_language:
                          type: string
                        original_title:
                          type: string
                        overview:
                          type: string
                        poster_path:
                          type: string
                        media_type:
                          type: string
                        genre_ids:
                          type: array
                        popularity:
                          type: number
                        release_date:
                          type: string
                        video:
                          type: boolean
                        vote_average:
                          type: number
                        vote_count:
                          type: integer
                  person_results:
                    type: array
                    description: >-
                      Contains an array of results related to individuals, such
                      as actors, directors, or other crew members.
                  tv_results:
                    type: array
                    description: >-
                      Contains an array of TV show-related results that match
                      the search criteria or ID provided.
                  tv_episode_results:
                    type: array
                    description: >-
                      Contains an array of TV episode-related results, including
                      details about specific episodes of a series.
                  tv_season_results:
                    type: array
                    description: >-
                      Contains an array of TV season-related results, including
                      details about specific seasons of a series.
                example:
                  movie_results:
                    - adult: false
                      backdrop_path: /44immBwzhDVyjn87b3x3l9mlhAD.jpg
                      id: 934433
                      title: Scream VI
                      original_language: en
                      original_title: Scream VI
                      overview: >-
                        Following the latest Ghostface killings, the four
                        survivors leave Woodsboro behind and start a fresh
                        chapter.
                      poster_path: /wDWwtvkRRlgTiUr6TyLSMX8FCuZ.jpg
                      media_type: movie
                      genre_ids:
                        - 27
                        - 9648
                        - 53
                      popularity: 853.917
                      release_date: '2023-03-08'
                      video: false
                      vote_average: 7.388
                      vote_count: 708
                  person_results: []
                  tv_results: []
                  tv_episode_results: []
                  tv_season_results: []
components:
  schemas:
    string:
      type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.