> ## Documentation Index > Fetch the complete documentation index at: https://sirjosh.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. ## OpenAPI ````yaml api-reference/openapi3.json get /3/find/{external_id} openapi: 3.0.3 info: title: The Movie Database version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: AUTHENTICATION - name: ACCOUNT - name: CERTIFICATIONS - name: CHANGES - name: COLLECTIONS - name: COMPANY - name: CONFIGURATION - name: CREDIT - name: DISCOVER - name: FIND - name: GENRES - name: GUEST SESSIONS - name: KEYWORDS - name: LISTS - name: MOVIE LISTS - name: MOVIES - name: NETWORKS - name: PEOPLE LIST - name: PEOPLE - name: REVIEWS - name: SEARCH - name: TRENDING - name: TV SERIES LIST - name: TV SERIES - name: TV SEASONS - name: TV EPISODES - name: TV EPISODE GROUP - name: WATCH PROVIDERS paths: /3/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 description: >- A unique identifier for an object (movie, TV show, person) in the specified external source. This is necessary to find a specific item you are looking for. schema: type: string example: '' - name: external_source in: query description: Specifies the source of the external ID required: true schema: type: string enum: - imdb_id - facebook_id - Instagram_id - tvdb_id, - tiktok_id - twitter_id - wikidata_id - youtube_id example: imdb_id - $ref: '#/components/parameters/language' 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=22968 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 03 Jan 2025 23:09:29 GMT ETag: schema: type: string example: W/"30d1084fe3d0aa3b9e72463680c022f6" 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 2f66aa06710fece8ed203ab0ea81eb56.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: Nbu_vUYvdo3rPlkKlBdfG0redl-d6xdHMiIVMrolbXI_vNgbPKtKrg== 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: '5448' x-memc-expires: schema: type: string example: '22968' 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 description: >- A boolean indicating whether the movie is intended for adults (true) or not (false). backdrop_path: type: string example: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg description: >- A string representing the file path to the movie's backdrop image. genre_ids: type: array items: type: number example: 28 example: - 28 - 12 - 18 description: >- An array of integers representing the genres the movie belongs to. id: type: number example: 558449 description: >- A unique identifier for the movie within the database. media_type: type: string example: movie description: >- Indicates the type of media returned, which in this case is a movie. Other possible values could include "tv" for television shows, depending on the API's response structure original_language: type: string example: en description: >- A string indicating the original language in which the movie was made. original_title: type: string example: Gladiator II description: The title of the movie in its original language. 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. description: A brief summary of the plot (eithr movie or TV show) popularity: type: number example: 5382.147 description: >- A numerical value representing the popularity of plot poster_path: type: string example: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg description: >- A string representing the file path to the movie's promotional poster . release_date: type: string example: '2024-11-05' description: >- A string indicating the release date of the movie in the format YYYY-MM-DD. title: type: string example: Gladiator II description: The title of the movie as presented to the audience. video: type: boolean example: false description: >- A boolean indicating whether the movie has an associated video (true) or not (false). vote_average: type: number example: 6.759 description: >- A numerical value representing the average rating of the movie based on user votes, typically given on a scale from 1 to 10. vote_count: type: number example: 1888 description: >- An integer representing the total number of votes received for the movie. example: - adult: false backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg genre_ids: - 28 - 12 - 18 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: 5382.147 poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg release_date: '2024-11-05' title: Gladiator II video: false vote_average: 6.759 vote_count: 1888 description: >- An array containing the results of movies based on the query. If the query doesn't return movie results, this array will be empty. person_results: type: array items: {} example: [] description: >- An array intended for returning information about individuals (e.g., actors, directors) related to the query. tv_episode_results: type: array items: {} example: [] description: >- An array designated for TV episode data related to the query. tv_results: type: array items: {} example: [] description: An array for returning results pertaining to TV shows. tv_season_results: type: array items: {} example: [] description: An array meant for TV season data relevant to the query. examples: find by id: value: movie_results: - adult: false backdrop_path: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg genre_ids: - 28 - 12 - 18 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: 5382.147 poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg release_date: '2024-11-05' title: Gladiator II video: false vote_average: 6.759 vote_count: 1888 person_results: [] tv_episode_results: [] tv_results: [] tv_season_results: [] components: parameters: language: name: language in: query description: Specifies the language in which the response should be returned. schema: type: string example: en-US securitySchemes: bearerAuth: type: http scheme: bearer ````