Find By ID
curl --request GET \
--url 'https://api.themoviedb.org/3/find/{{external_id}}' \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.themoviedb.org/3/find/{{external_id}}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.themoviedb.org/3/find/{{external_id}}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.themoviedb.org/3/find/{{external_id}}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.themoviedb.org/3/find/{{external_id}}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.themoviedb.org/3/find/{{external_id}}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.themoviedb.org/3/find/{{external_id}}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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": []
}FIND
Find By ID
This endpoint finds data by external ID’s.
GET
/
3
/
find
/
{external_id}
Find By ID
curl --request GET \
--url 'https://api.themoviedb.org/3/find/{{external_id}}' \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.themoviedb.org/3/find/{{external_id}}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.themoviedb.org/3/find/{{external_id}}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.themoviedb.org/3/find/{{external_id}}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.themoviedb.org/3/find/{{external_id}}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.themoviedb.org/3/find/{{external_id}}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.themoviedb.org/3/find/{{external_id}}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
Example:
[]
Show child attributes
Show child attributes
Example:
[
{
"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"
}
]
Example:
[]
Example:
[]
Example:
[]
⌘I