> ## Documentation Index > Fetch the complete documentation index at: https://tvc.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Find By ID > This endpoint finds data by external ID's. ## OpenAPI ````yaml get /3/find/{{external_id}} openapi: 3.0.3 info: title: TMDb Endpoints description: >- Welcome to the TMDb API! You'll find a well-organized collection of endpoints, each helping you fetch different types of movie and TV data. The endpoints cover everything from searching for titles and getting details to managing lists and accessing ratings, all designed to give you precise control over the information you need. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org description: Test server - url: https://api.themoviedb.org/3 description: Production server - url: '{{base_url}}' description: Some other server security: [] tags: - name: AUTHENTICATION description: The /account/{account_id} gets the public details of an account on TMDB. - name: ACCOUNT description: >- Account endpoints allow users to manage their personal information, ratings, watchlists, and other account-related data after authenticating. - name: CERTIFICATIONS description: >- The Certifications endpoints provide lists of movie and TV show content rating systems used in various countries. - name: CHANGES description: >- Changes endpoints allow you to track modifications made to movies, TV shows, and people in the TMDb database, providing a history of updates and enabling you to keep your local data synchronized. - name: COLLECTIONS - name: COMPANIES - name: CONFIGURATION - name: CREDITS - name: DISCOVER description: >- Discover endpoints are powerful tools for finding movies and TV shows based on a wide range of criteria, such as genre, release date, rating, keywords, and more, enabling highly customized searches. - name: FIND description: This folder has find by ID endpoint - name: GENRES description: >- Genres endpoints provide lists of available movie and TV show genres, allowing you to categorize and filter content. - name: GUEST SESSIONS description: >- Guest session endpoints allow you to create temporary, unauthenticated sessions that grant limited access to certain API features, such as rating movies or TV shows without requiring a full user account. - name: KEYWORDS description: >- Keyword endpoints allow you to search for keywords and retrieve detailed information about specific keywords and the media associated with them. - name: LISTS description: >- Lists endpoints allow you to create, retrieve, modify, and delete custom lists of movies or TV shows. - name: MOVIE LIST description: >- The Movie List endpoints let you retrieve pre-made lists of movies, categorized by criteria like popularity, top rated, now playing, or upcoming releases. - name: MOVIES description: >- The Movie endpoints allow you to retrieve detailed information about movies, including titles, descriptions, cast, crew, ratings, and related data. - name: NETWORKS description: >- The NETWORKS endpoints let you retrieve information about television networks, such as their names, logos, and origin countries. - name: PEOPLE LISTS description: >- The People Lists endpoints let you retrieve lists of people based on criteria like popularity. - name: PEOPLE description: >- The PEOPLE endpoints let you get information about actors, directors, and other people involved in movies and TV shows. - name: REVIEWS description: >- The REVIEWS endpoints let you get user-written opinions and ratings about movies and TV shows. - name: SEARCH description: >- The "Search" endpoints let you find movies, TV shows, people, and other content by typing in keywords or names. - name: TRENDING description: >- The "Trending" endpoints show you what movies, TV shows, and people are currently popular or getting a lot of attention right now. - name: TV SERIES LISTS description: >- TV Series Lists endpoints provide access to pre-defined lists of TV shows, such as popular, top-rated, or airing today, allowing you to quickly retrieve collections of TV series based on specific criteria. - name: TV SERIES description: >- The TV series endpoints provide access to a wealth of information about television shows, including details, credits, seasons, episodes, recommendations, and more. See each of them below for specific information. - name: TV SEASONS description: >- The TV seasons endpoints allow you to retrieve details about specific seasons of a TV show, including information about the episodes within that season. See them below for specific information on how to use them. - name: TV EPISODES description: >- The TV episode endpoints allow you to retrieve detailed information about specific episodes of a TV show, including details like the episode number, name, air date, overview, and more. Check them out for specific information. - name: TV EPISODE GROUPS description: >- There's only one endpoint in this folder. Check the endpoint to find information about it. - name: WATCH PROVIDERS description: >- The Watch Providers endpoints provide information about streaming services, rental/purchase platforms, and sometimes even theatrical releases in different regions. paths: /3/find/{{external_id}}: parameters: - name: external_id in: path required: true schema: type: string get: tags: - FIND summary: Find By ID description: This endpoint finds data by external ID's. operationId: findById parameters: - name: external_source in: query schema: type: string example: facebook_id responses: '200': description: Find By ID Example headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=27335 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 10 Jan 2025 16:45:17 GMT ETag: schema: type: string example: W/"63be4ac6076e71504f0d1e27f4d3b363" 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 89a2789e584c965cee4a77ee2a943764.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: Tpt53hTbR6gww6XME0x452JenUaMnOXEc04E01X5KJkT0s0BuBSCxQ== X-Amz-Cf-Pop: schema: type: string example: LOS50-P2 X-Cache: schema: type: string example: Miss from cloudfront x-memc: schema: type: string example: HIT x-memc-age: schema: type: string example: '140' x-memc-expires: schema: type: string example: '27335' x-memc-key: schema: type: string example: 26333a5af1a0e640836f1d85b88ad6ed content: application/json: schema: type: object properties: movie_results: type: array items: {} example: [] person_results: type: array items: type: object properties: adult: type: boolean example: false gender: type: number example: 2 id: type: number example: 500 known_for: type: array items: type: object properties: adult: type: boolean example: false backdrop_path: type: string example: /4V1yIoAKPMRQwGBaSses8Bp2nsi.jpg genre_ids: type: array items: type: number example: 28 example: - 28 - 878 id: type: number example: 137113 media_type: type: string example: movie original_language: type: string example: en original_title: type: string example: Edge of Tomorrow overview: type: string example: >- Major Bill Cage is an officer who has never seen a day of combat when he is unceremoniously demoted and dropped into combat. Cage is killed within minutes, managing to take an alpha alien down with him. He awakens back at the beginning of the same day and is forced to fight and die again... and again - as physical contact with the alien has thrown him into a time loop. popularity: type: number example: 73.24 poster_path: type: string example: /uUHvlkLavotfGsNtosDy8ShsIYF.jpg release_date: type: string example: '2014-05-27' title: type: string example: Edge of Tomorrow video: type: boolean example: false vote_average: type: number example: 7.627 vote_count: type: number example: 13900 example: - adult: false backdrop_path: /4V1yIoAKPMRQwGBaSses8Bp2nsi.jpg genre_ids: - 28 - 878 id: 137113 media_type: movie original_language: en original_title: Edge of Tomorrow overview: >- Major Bill Cage is an officer who has never seen a day of combat when he is unceremoniously demoted and dropped into combat. Cage is killed within minutes, managing to take an alpha alien down with him. He awakens back at the beginning of the same day and is forced to fight and die again... and again - as physical contact with the alien has thrown him into a time loop. popularity: 73.24 poster_path: /uUHvlkLavotfGsNtosDy8ShsIYF.jpg release_date: '2014-05-27' title: Edge of Tomorrow video: false vote_average: 7.627 vote_count: 13900 - adult: false backdrop_path: /sbkYWB5QcfT00gLUkbNE5LTdhIX.jpg genre_ids: - 28 - 878 - 12 - 9648 id: 75612 media_type: movie original_language: en original_title: Oblivion overview: >- Jack Harper is one of the last few drone repairmen stationed on Earth. Part of a massive operation to extract vital resources after decades of war with a terrifying threat known as the Scavs, Jack’s mission is nearly complete. His existence is brought crashing down when he rescues a beautiful stranger from a downed spacecraft. Her arrival triggers a chain of events that forces him to question everything he knows and puts the fate of humanity in his hands. popularity: 70.12 poster_path: /5Onf4TW3mZn3oLeKVr9W4FGomQQ.jpg release_date: '2013-04-10' title: Oblivion video: false vote_average: 6.65 vote_count: 10697 - adult: false backdrop_path: /ih4lZkUpmSE7AP3maymiO72xJ1z.jpg genre_ids: - 28 - 53 - 12 id: 56292 media_type: movie original_language: en original_title: 'Mission: Impossible - Ghost Protocol' overview: >- Ethan Hunt and his team are racing against time to track down a dangerous terrorist named Hendricks, who has gained access to Russian nuclear launch codes and is planning a strike on the United States. An attempt to stop him ends in an explosion causing severe destruction to the Kremlin and the IMF to be implicated in the bombing, forcing the President to disavow them. No longer being aided by the government, Ethan and his team chase Hendricks around the globe, although they might still be too late to stop a disaster. popularity: 51.336 poster_path: /eRZTGx7GsiKqPch96k27LK005ZL.jpg release_date: '2011-12-07' title: 'Mission: Impossible - Ghost Protocol' video: false vote_average: 7.092 vote_count: 9909 known_for_department: type: string example: Acting media_type: type: string example: person name: type: string example: Tom Cruise original_name: type: string example: Tom Cruise popularity: type: number example: 156.754 profile_path: type: string example: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg example: - adult: false gender: 2 id: 500 known_for: - adult: false backdrop_path: /4V1yIoAKPMRQwGBaSses8Bp2nsi.jpg genre_ids: - 28 - 878 id: 137113 media_type: movie original_language: en original_title: Edge of Tomorrow overview: >- Major Bill Cage is an officer who has never seen a day of combat when he is unceremoniously demoted and dropped into combat. Cage is killed within minutes, managing to take an alpha alien down with him. He awakens back at the beginning of the same day and is forced to fight and die again... and again - as physical contact with the alien has thrown him into a time loop. popularity: 73.24 poster_path: /uUHvlkLavotfGsNtosDy8ShsIYF.jpg release_date: '2014-05-27' title: Edge of Tomorrow video: false vote_average: 7.627 vote_count: 13900 - adult: false backdrop_path: /sbkYWB5QcfT00gLUkbNE5LTdhIX.jpg genre_ids: - 28 - 878 - 12 - 9648 id: 75612 media_type: movie original_language: en original_title: Oblivion overview: >- Jack Harper is one of the last few drone repairmen stationed on Earth. Part of a massive operation to extract vital resources after decades of war with a terrifying threat known as the Scavs, Jack’s mission is nearly complete. His existence is brought crashing down when he rescues a beautiful stranger from a downed spacecraft. Her arrival triggers a chain of events that forces him to question everything he knows and puts the fate of humanity in his hands. popularity: 70.12 poster_path: /5Onf4TW3mZn3oLeKVr9W4FGomQQ.jpg release_date: '2013-04-10' title: Oblivion video: false vote_average: 6.65 vote_count: 10697 - adult: false backdrop_path: /ih4lZkUpmSE7AP3maymiO72xJ1z.jpg genre_ids: - 28 - 53 - 12 id: 56292 media_type: movie original_language: en original_title: 'Mission: Impossible - Ghost Protocol' overview: >- Ethan Hunt and his team are racing against time to track down a dangerous terrorist named Hendricks, who has gained access to Russian nuclear launch codes and is planning a strike on the United States. An attempt to stop him ends in an explosion causing severe destruction to the Kremlin and the IMF to be implicated in the bombing, forcing the President to disavow them. No longer being aided by the government, Ethan and his team chase Hendricks around the globe, although they might still be too late to stop a disaster. popularity: 51.336 poster_path: /eRZTGx7GsiKqPch96k27LK005ZL.jpg release_date: '2011-12-07' title: 'Mission: Impossible - Ghost Protocol' video: false vote_average: 7.092 vote_count: 9909 known_for_department: Acting media_type: person name: Tom Cruise original_name: Tom Cruise popularity: 156.754 profile_path: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg tv_episode_results: type: array items: {} example: [] tv_results: type: array items: {} example: [] tv_season_results: type: array items: {} example: [] examples: Find By ID Example: value: movie_results: [] person_results: - adult: false gender: 2 id: 500 known_for: - adult: false backdrop_path: /4V1yIoAKPMRQwGBaSses8Bp2nsi.jpg genre_ids: - 28 - 878 id: 137113 media_type: movie original_language: en original_title: Edge of Tomorrow overview: >- Major Bill Cage is an officer who has never seen a day of combat when he is unceremoniously demoted and dropped into combat. Cage is killed within minutes, managing to take an alpha alien down with him. He awakens back at the beginning of the same day and is forced to fight and die again... and again - as physical contact with the alien has thrown him into a time loop. popularity: 73.24 poster_path: /uUHvlkLavotfGsNtosDy8ShsIYF.jpg release_date: '2014-05-27' title: Edge of Tomorrow video: false vote_average: 7.627 vote_count: 13900 - adult: false backdrop_path: /sbkYWB5QcfT00gLUkbNE5LTdhIX.jpg genre_ids: - 28 - 878 - 12 - 9648 id: 75612 media_type: movie original_language: en original_title: Oblivion overview: >- Jack Harper is one of the last few drone repairmen stationed on Earth. Part of a massive operation to extract vital resources after decades of war with a terrifying threat known as the Scavs, Jack’s mission is nearly complete. His existence is brought crashing down when he rescues a beautiful stranger from a downed spacecraft. Her arrival triggers a chain of events that forces him to question everything he knows and puts the fate of humanity in his hands. popularity: 70.12 poster_path: /5Onf4TW3mZn3oLeKVr9W4FGomQQ.jpg release_date: '2013-04-10' title: Oblivion video: false vote_average: 6.65 vote_count: 10697 - adult: false backdrop_path: /ih4lZkUpmSE7AP3maymiO72xJ1z.jpg genre_ids: - 28 - 53 - 12 id: 56292 media_type: movie original_language: en original_title: 'Mission: Impossible - Ghost Protocol' overview: >- Ethan Hunt and his team are racing against time to track down a dangerous terrorist named Hendricks, who has gained access to Russian nuclear launch codes and is planning a strike on the United States. An attempt to stop him ends in an explosion causing severe destruction to the Kremlin and the IMF to be implicated in the bombing, forcing the President to disavow them. No longer being aided by the government, Ethan and his team chase Hendricks around the globe, although they might still be too late to stop a disaster. popularity: 51.336 poster_path: /eRZTGx7GsiKqPch96k27LK005ZL.jpg release_date: '2011-12-07' title: 'Mission: Impossible - Ghost Protocol' video: false vote_average: 7.092 vote_count: 9909 known_for_department: Acting media_type: person name: Tom Cruise original_name: Tom Cruise popularity: 156.754 profile_path: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg tv_episode_results: [] tv_results: [] tv_season_results: [] security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer ````