Find by ID

This endpoint find data by external ID’s.

GET /find/{external_id}

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": "/44immBwzhDVyjn87b3x3l9mlhAD.jpg",
      "id": 934433,
      "title": "Scream VI",
      "original_language": "en",
      "original_title": "Scream VI",
      "overview": "Following the latest Ghostface killings, the four survivors leave Woodsboro behind and start a fresh chapter.",
      "poster_path": "/wDWwtvkRRlgTiUr6TyLSMX8FCuZ.jpg",
      "media_type": "movie",
      "genre_ids": [
        27,
        9648,
        53
      ],
      "popularity": 853.917,
      "release_date": "2023-03-08",
      "video": false,
      "vote_average": 7.388,
      "vote_count": 708
    }
  ],
  "person_results": [],
  "tv_results": [],
  "tv_episode_results": [],
  "tv_season_results": []
}

Source	Movies	TV Shows	TV Seasons	TV Episodes	People
IMDb	✅	✅		✅	✅
Facebook	✅	✅			✅
Instagram	✅	✅			✅
TheTVDB		✅	✅	✅
TikTok	✅	✅			✅
Twitter	✅	✅			✅
Wikidata	✅	✅	✅	✅	✅
YouTube	✅	✅			✅

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

The external ID to find the movie

Query Parameters

external_source · string · required

The external source of the movie

language · string

Defaults to en-US

Response

200 - application/json

Successful

movie_results · object[]

Contains an array of movie-related results that match the search criteria or ID provided.

Show child attributes

person_results · array

Contains an array of results related to individuals, such as actors, directors, or other crew members.

tv_results · array

Contains an array of TV show-related results that match the search criteria or ID provided.

tv_episode_results · array

Contains an array of TV episode-related results, including details about specific episodes of a series.

tv_season_results · array

Contains an array of TV season-related results, including details about specific seasons of a series.