GET
/
3
/
find
/
{external_id}
Find By ID
curl --request GET \
  --url https://api.themoviedb.org/3/find/{external_id} \
  --header 'Authorization: Bearer <token>'
{
  "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": []
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
external_id
string
required

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.

Example:

""

Query Parameters

​
external_source
enum<string>
required

Specifies the source of the external ID

Available options:
imdb_id,
facebook_id,
Instagram_id,
tvdb_id,,
tiktok_id,
twitter_id,
wikidata_id,
youtube_id
Example:

"imdb_id"

​
language
string

Specifies the language in which the response should be returned.

Example:

"en-US"

Response

200 - application/json

find by id

​
movie_results
object[]

An array containing the results of movies based on the query. If the query doesn't return movie results, this array will be empty.

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
  }
]
​
person_results
any[]

An array intended for returning information about individuals (e.g., actors, directors) related to the query.

Example:
[]
​
tv_episode_results
any[]

An array designated for TV episode data related to the query.

Example:
[]
​
tv_results
any[]

An array for returning results pertaining to TV shows.

Example:
[]
​
tv_season_results
any[]

An array meant for TV season data relevant to the query.

Example:
[]