ACCOUNT
- Endpoints
AUTHENTICATION
- Endpoints
CERTIFICATIONS
- Endpoints
CHANGES
- Endpoints
COLLECTIONS
- Endpoints
COMPANIES
- Endpoints
CONFIGURATION
- Endpoints
CREDITS
FIND
GENRES
GUEST-SESSIONS
KEYWORDS
MOVIES
PEOPLE
PEOPLE-LISTS
REVIEWS
TV-EPISODE-GROUPS
TV-EPISODES
TV-SEASONS
TV-SERIES
TV-SERIES-LISTS
WATCH-PROVIDERS
FIND
Find By ID
This endpoint finds data by external ID’s.
GET
/
3
/
find
/
{external_id}
Copy
curl --request GET \
--url https://api.themoviedb.org/3/find/%7B{external_id}%7D \
--header 'Authorization: Bearer <token>'
Copy
{
"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": []
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Query Parameters
Example:
"facebook_id"
Response
200 - application/json
Find By ID Example
The response is of type object
.
Copy
curl --request GET \
--url https://api.themoviedb.org/3/find/%7B{external_id}%7D \
--header 'Authorization: Bearer <token>'
Copy
{
"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": []
}
Assistant
Responses are generated using AI and may contain mistakes.