Find by ID

This endpoint find data by external ID’s.

GET /3/find/{external_id}

Try it

Find by ID

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/find/{external_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "movie_results": [
    {
      "adult": false,
      "backdrop_path": "/cjEcqdRdPQJhYre3HUAc5538Gk8.jpg",
      "genre_ids": [
        28,
        14,
        35
      ],
      "id": 845781,
      "media_type": "movie",
      "original_language": "en",
      "original_title": "Red One",
      "overview": "After Santa Claus (codename: Red One) is kidnapped, the North Pole's Head of Security must team up with the world's most infamous tracker in a globe-trotting, action-packed mission to save Christmas.",
      "popularity": 896.528,
      "poster_path": "/cdqLnri3NEGcmfnqwk2TSIYtddg.jpg",
      "release_date": "2024-10-31",
      "title": "Red One",
      "video": false,
      "vote_average": 7.109,
      "vote_count": 2127
    }
  ],
  "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

Example:

"redonemov"

Query Parameters

external_source · enum<string> · required

Available options: imdb_id, facebook_id, instagram_id, tvdb_id, tiktok_id, twitter_id, wikidata_id, youtube_id

language · string

Example:

"en-US"

Response

200 - application/json

Find by ID

movie_results · object[]

Show child attributes

movie_results. adult · boolean

Example:

false

movie_results. backdrop_path · string

Example:

"/cjEcqdRdPQJhYre3HUAc5538Gk8.jpg"

movie_results. genre_ids · number[]

Example:

[28, 14, 35]

movie_results. id · number

Example:

845781

movie_results. media_type · string

Example:

"movie"

movie_results. original_language · string

Example:

"en"

movie_results. original_title · string

Example:

"Red One"

movie_results. overview · string

Example:

"After Santa Claus (codename: Red One) is kidnapped, the North Pole's Head of Security must team up with the world's most infamous tracker in a globe-trotting, action-packed mission to save Christmas."

movie_results. popularity · number

Example:

896.528

movie_results. poster_path · string

Example:

"/cdqLnri3NEGcmfnqwk2TSIYtddg.jpg"

movie_results. release_date · string

Example:

"2024-10-31"

movie_results. title · string

Example:

"Red One"

movie_results. video · boolean

Example:

false

movie_results. vote_average · number

Example:

7.109

movie_results. vote_count · number

Example:

2127

Example:

[
  {
    "adult": false,
    "backdrop_path": "/cjEcqdRdPQJhYre3HUAc5538Gk8.jpg",
    "genre_ids": [28, 14, 35],
    "id": 845781,
    "media_type": "movie",
    "original_language": "en",
    "original_title": "Red One",
    "overview": "After Santa Claus (codename: Red One) is kidnapped, the North Pole's Head of Security must team up with the world's most infamous tracker in a globe-trotting, action-packed mission to save Christmas.",
    "popularity": 896.528,
    "poster_path": "/cdqLnri3NEGcmfnqwk2TSIYtddg.jpg",
    "release_date": "2024-10-31",
    "title": "Red One",
    "video": false,
    "vote_average": 7.109,
    "vote_count": 2127
  }
]

person_results · any[]

Example:

[]

tv_episode_results · any[]

Example:

[]

tv_results · any[]

Example:

[]

tv_season_results · any[]

Example:

[]