> ## 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. # Find By External ID > This endpoint allows you to search for all objects in our database, including movies, TV shows, and persons, by an external ID. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/find/{{external_id}} 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/find/{{external_id}}: parameters: - name: external_id in: path description: This represents the external ID. Get it [here]() required: true schema: type: string get: tags: - Find summary: Find By External ID description: >- This endpoint allows you to search for all objects in our database, including movies, TV shows, and persons, by an external ID. operationId: findByExternalId parameters: - name: external_source in: query schema: type: string enum: - imdb_id - facebook_id - instagram_id - tvdb_id - tiktok_id - twitter_id - wikidata_id - youtube_id example: imdb_id description: >- This represents the external source. Check it out [here](https://starlight.mintlify.app/api-reference/supportedsources). responses: '200': description: Find By External ID headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=10517 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Mon, 16 Dec 2024 12:26:34 GMT ETag: schema: type: string example: W/"4484adbea050c5db2d9619bd56d0ba51" 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 3dcb635971b5d310e8941cdb963aff70.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: gI-_ilvHyVLIKTy004b5E0T_PkRHysplQa0F3pnJhk3rZnS15POegw== 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: '13249' x-memc-expires: schema: type: string example: '10517' x-memc-key: schema: type: string example: f233287a525599e9d1f29d7da70b133a content: application/json: schema: type: object properties: movie_results: type: array items: {} example: [] person_results: type: array items: {} example: [] tv_episode_results: type: array items: {} example: [] tv_results: type: array items: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /gc8PfyTqzqltKPW3X0cIVUGmagz.jpg first_air_date: type: string example: '2008-01-20' genre_ids: type: array items: type: number example: 18 example: - 18 - 80 id: type: number example: 1396 media_type: type: string example: tv name: type: string example: Breaking Bad origin_country: type: array items: type: string example: US example: - US original_language: type: string example: en original_name: type: string example: Breaking Bad overview: type: string example: >- Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime. popularity: type: number example: 560.37 poster_path: type: string example: /ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg vote_average: type: number example: 8.917 vote_count: type: number example: 14636 example: - adult: false backdrop_path: /gc8PfyTqzqltKPW3X0cIVUGmagz.jpg first_air_date: '2008-01-20' genre_ids: - 18 - 80 id: 1396 media_type: tv name: Breaking Bad origin_country: - US original_language: en original_name: Breaking Bad overview: >- Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime. popularity: 560.37 poster_path: /ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg vote_average: 8.917 vote_count: 14636 tv_season_results: type: array items: {} example: [] examples: Find By External ID: value: movie_results: [] person_results: [] tv_episode_results: [] tv_results: - adult: false backdrop_path: /gc8PfyTqzqltKPW3X0cIVUGmagz.jpg first_air_date: '2008-01-20' genre_ids: - 18 - 80 id: 1396 media_type: tv name: Breaking Bad origin_country: - US original_language: en original_name: Breaking Bad overview: >- Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime. popularity: 560.37 poster_path: /ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg vote_average: 8.917 vote_count: 14636 tv_season_results: [] components: securitySchemes: bearerAuth: type: http scheme: bearer ````