People
curl --request GET \
--url 'https://api.themoviedb.org/3/trending/person/{{time_window}}' \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.themoviedb.org/3/trending/person/{{time_window}}"
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/trending/person/{{time_window}}', 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/trending/person/{{time_window}}",
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/trending/person/{{time_window}}"
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/trending/person/{{time_window}}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.themoviedb.org/3/trending/person/{{time_window}}")
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{
"page": 1,
"results": [
{
"adult": false,
"gender": 2,
"id": 18918,
"known_for_department": "Acting",
"media_type": "person",
"name": "Dwayne Johnson",
"original_name": "Dwayne Johnson",
"popularity": 99.244,
"profile_path": "/kuqFzlYMc2IrsOyPznMd1FroeGq.jpg"
},
{
"adult": false,
"gender": 2,
"id": 2461,
"known_for_department": "Acting",
"media_type": "person",
"name": "Mel Gibson",
"original_name": "Mel Gibson",
"popularity": 192.688,
"profile_path": "/jnqHMaOslt8cef2atSmOpGRvNla.jpg"
},
{
"adult": false,
"gender": 0,
"id": 1067215,
"known_for_department": "Acting",
"media_type": "person",
"name": "Yardar Parnsombat",
"original_name": "ญาดา ปานสมบัติ",
"popularity": 0.157,
"profile_path": null
},
{
"adult": false,
"gender": 1,
"id": 4153819,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jeong Yoon-I",
"original_name": "Jeong Yoon-I",
"popularity": 25.038,
"profile_path": "/zsIMMBDLYkAOM0LfziQR8hkc46M.jpg"
},
{
"adult": false,
"gender": 1,
"id": 2472212,
"known_for_department": "Acting",
"media_type": "person",
"name": "Sae Bom",
"original_name": "Sae Bom",
"popularity": 12.051,
"profile_path": "/mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg"
},
{
"adult": false,
"gender": 1,
"id": 5009979,
"known_for_department": null,
"media_type": "person",
"name": "河北彩花",
"original_name": "河北彩花",
"popularity": 7.213,
"profile_path": "/pDVfME2z2DiosnHFBALHvoSvqs5.jpg"
},
{
"adult": false,
"gender": 2,
"id": 11505,
"known_for_department": "Writing",
"media_type": "person",
"name": "John Hughes",
"original_name": "John Hughes",
"popularity": 25.555,
"profile_path": "/nfGhXH2zcGPAOw8kNbnes516aZG.jpg"
},
{
"adult": false,
"gender": 1,
"id": 2227,
"known_for_department": "Acting",
"media_type": "person",
"name": "Nicole Kidman",
"original_name": "Nicole Kidman",
"popularity": 107.888,
"profile_path": "/lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg"
},
{
"adult": false,
"gender": 1,
"id": 5009810,
"known_for_department": "Acting",
"media_type": "person",
"name": "河北彩花",
"original_name": "河北彩花",
"popularity": 5.565,
"profile_path": "/5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg"
},
{
"adult": false,
"gender": 2,
"id": 15111,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jean-Claude Van Damme",
"original_name": "Jean-Claude Van Damme",
"popularity": 84.447,
"profile_path": "/7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg"
},
{
"adult": false,
"gender": 2,
"id": 976,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jason Statham",
"original_name": "Jason Statham",
"popularity": 156.507,
"profile_path": "/whNwkEQYWLFJA8ij0WyOOAD5xhQ.jpg"
},
{
"adult": false,
"gender": 1,
"id": 1997928,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jin Joo",
"original_name": "진주",
"popularity": 82.062,
"profile_path": "/awN0RgLUn0j8AsGsC4JNT1gdkVI.jpg"
},
{
"adult": false,
"gender": 1,
"id": 1622390,
"known_for_department": "Acting",
"media_type": "person",
"name": "Lee Chae-dam",
"original_name": "Lee Chae-dam",
"popularity": 23.379,
"profile_path": "/7wMyr6F3yzvbSpu2XMxSW3vObED.jpg"
},
{
"adult": false,
"gender": 1,
"id": 3165040,
"known_for_department": "Acting",
"media_type": "person",
"name": "Rika",
"original_name": "Rika",
"popularity": 77.329,
"profile_path": "/vwYqrhcSRVrnra4S0NopnywN8rK.jpg"
},
{
"adult": false,
"gender": 2,
"id": 6193,
"known_for_department": "Acting",
"media_type": "person",
"name": "Leonardo DiCaprio",
"original_name": "Leonardo DiCaprio",
"popularity": 119.894,
"profile_path": "/ts9l18VkDSooRGDWIeQegNVHciC.jpg"
},
{
"adult": false,
"gender": 2,
"id": 1269,
"known_for_department": "Acting",
"media_type": "person",
"name": "Kevin Costner",
"original_name": "Kevin Costner",
"popularity": 72.762,
"profile_path": "/608blZipRDZkDpzp8VItB64qMaT.jpg"
},
{
"adult": false,
"gender": 2,
"id": 2963,
"known_for_department": "Acting",
"media_type": "person",
"name": "Nicolas Cage",
"original_name": "Nicolas Cage",
"popularity": 95.498,
"profile_path": "/ar33qcWbEgREn07ZpXv5Pbj8hbM.jpg"
},
{
"adult": false,
"gender": 2,
"id": 1435525,
"known_for_department": "Directing",
"media_type": "person",
"name": "Jerry White Jr.",
"original_name": "Jerry White Jr.",
"popularity": 0.001,
"profile_path": "/ly85IL1VACCPSxaKtyBbFTBuWYB.jpg"
},
{
"adult": false,
"gender": 1,
"id": 204,
"known_for_department": "Acting",
"media_type": "person",
"name": "Kate Winslet",
"original_name": "Kate Winslet",
"popularity": 51.616,
"profile_path": "/e3tdop3WhseRnn8KwMVLAV25Ybv.jpg"
},
{
"adult": false,
"gender": 1,
"id": 25837,
"known_for_department": "Acting",
"media_type": "person",
"name": "Elisha Cuthbert",
"original_name": "Elisha Cuthbert",
"popularity": 67.77,
"profile_path": "/lsNwsJjGZqgjVUI1mhtcDCuwES3.jpg"
}
],
"total_pages": 229,
"total_results": 4577
}TRENDING
People
This endpoint gets the trending people on TMDB.
GET
/
3
/
trending
/
person
/
{time_window}
People
curl --request GET \
--url 'https://api.themoviedb.org/3/trending/person/{{time_window}}' \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.themoviedb.org/3/trending/person/{{time_window}}"
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/trending/person/{{time_window}}', 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/trending/person/{{time_window}}",
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/trending/person/{{time_window}}"
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/trending/person/{{time_window}}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.themoviedb.org/3/trending/person/{{time_window}}")
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{
"page": 1,
"results": [
{
"adult": false,
"gender": 2,
"id": 18918,
"known_for_department": "Acting",
"media_type": "person",
"name": "Dwayne Johnson",
"original_name": "Dwayne Johnson",
"popularity": 99.244,
"profile_path": "/kuqFzlYMc2IrsOyPznMd1FroeGq.jpg"
},
{
"adult": false,
"gender": 2,
"id": 2461,
"known_for_department": "Acting",
"media_type": "person",
"name": "Mel Gibson",
"original_name": "Mel Gibson",
"popularity": 192.688,
"profile_path": "/jnqHMaOslt8cef2atSmOpGRvNla.jpg"
},
{
"adult": false,
"gender": 0,
"id": 1067215,
"known_for_department": "Acting",
"media_type": "person",
"name": "Yardar Parnsombat",
"original_name": "ญาดา ปานสมบัติ",
"popularity": 0.157,
"profile_path": null
},
{
"adult": false,
"gender": 1,
"id": 4153819,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jeong Yoon-I",
"original_name": "Jeong Yoon-I",
"popularity": 25.038,
"profile_path": "/zsIMMBDLYkAOM0LfziQR8hkc46M.jpg"
},
{
"adult": false,
"gender": 1,
"id": 2472212,
"known_for_department": "Acting",
"media_type": "person",
"name": "Sae Bom",
"original_name": "Sae Bom",
"popularity": 12.051,
"profile_path": "/mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg"
},
{
"adult": false,
"gender": 1,
"id": 5009979,
"known_for_department": null,
"media_type": "person",
"name": "河北彩花",
"original_name": "河北彩花",
"popularity": 7.213,
"profile_path": "/pDVfME2z2DiosnHFBALHvoSvqs5.jpg"
},
{
"adult": false,
"gender": 2,
"id": 11505,
"known_for_department": "Writing",
"media_type": "person",
"name": "John Hughes",
"original_name": "John Hughes",
"popularity": 25.555,
"profile_path": "/nfGhXH2zcGPAOw8kNbnes516aZG.jpg"
},
{
"adult": false,
"gender": 1,
"id": 2227,
"known_for_department": "Acting",
"media_type": "person",
"name": "Nicole Kidman",
"original_name": "Nicole Kidman",
"popularity": 107.888,
"profile_path": "/lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg"
},
{
"adult": false,
"gender": 1,
"id": 5009810,
"known_for_department": "Acting",
"media_type": "person",
"name": "河北彩花",
"original_name": "河北彩花",
"popularity": 5.565,
"profile_path": "/5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg"
},
{
"adult": false,
"gender": 2,
"id": 15111,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jean-Claude Van Damme",
"original_name": "Jean-Claude Van Damme",
"popularity": 84.447,
"profile_path": "/7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg"
},
{
"adult": false,
"gender": 2,
"id": 976,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jason Statham",
"original_name": "Jason Statham",
"popularity": 156.507,
"profile_path": "/whNwkEQYWLFJA8ij0WyOOAD5xhQ.jpg"
},
{
"adult": false,
"gender": 1,
"id": 1997928,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jin Joo",
"original_name": "진주",
"popularity": 82.062,
"profile_path": "/awN0RgLUn0j8AsGsC4JNT1gdkVI.jpg"
},
{
"adult": false,
"gender": 1,
"id": 1622390,
"known_for_department": "Acting",
"media_type": "person",
"name": "Lee Chae-dam",
"original_name": "Lee Chae-dam",
"popularity": 23.379,
"profile_path": "/7wMyr6F3yzvbSpu2XMxSW3vObED.jpg"
},
{
"adult": false,
"gender": 1,
"id": 3165040,
"known_for_department": "Acting",
"media_type": "person",
"name": "Rika",
"original_name": "Rika",
"popularity": 77.329,
"profile_path": "/vwYqrhcSRVrnra4S0NopnywN8rK.jpg"
},
{
"adult": false,
"gender": 2,
"id": 6193,
"known_for_department": "Acting",
"media_type": "person",
"name": "Leonardo DiCaprio",
"original_name": "Leonardo DiCaprio",
"popularity": 119.894,
"profile_path": "/ts9l18VkDSooRGDWIeQegNVHciC.jpg"
},
{
"adult": false,
"gender": 2,
"id": 1269,
"known_for_department": "Acting",
"media_type": "person",
"name": "Kevin Costner",
"original_name": "Kevin Costner",
"popularity": 72.762,
"profile_path": "/608blZipRDZkDpzp8VItB64qMaT.jpg"
},
{
"adult": false,
"gender": 2,
"id": 2963,
"known_for_department": "Acting",
"media_type": "person",
"name": "Nicolas Cage",
"original_name": "Nicolas Cage",
"popularity": 95.498,
"profile_path": "/ar33qcWbEgREn07ZpXv5Pbj8hbM.jpg"
},
{
"adult": false,
"gender": 2,
"id": 1435525,
"known_for_department": "Directing",
"media_type": "person",
"name": "Jerry White Jr.",
"original_name": "Jerry White Jr.",
"popularity": 0.001,
"profile_path": "/ly85IL1VACCPSxaKtyBbFTBuWYB.jpg"
},
{
"adult": false,
"gender": 1,
"id": 204,
"known_for_department": "Acting",
"media_type": "person",
"name": "Kate Winslet",
"original_name": "Kate Winslet",
"popularity": 51.616,
"profile_path": "/e3tdop3WhseRnn8KwMVLAV25Ybv.jpg"
},
{
"adult": false,
"gender": 1,
"id": 25837,
"known_for_department": "Acting",
"media_type": "person",
"name": "Elisha Cuthbert",
"original_name": "Elisha Cuthbert",
"popularity": 67.77,
"profile_path": "/lsNwsJjGZqgjVUI1mhtcDCuwES3.jpg"
}
],
"total_pages": 229,
"total_results": 4577
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
200 - application/json
People Example
Example:
1
Show child attributes
Show child attributes
Example:
[
{
"adult": false,
"gender": 2,
"id": 18918,
"known_for_department": "Acting",
"media_type": "person",
"name": "Dwayne Johnson",
"original_name": "Dwayne Johnson",
"popularity": 99.244,
"profile_path": "/kuqFzlYMc2IrsOyPznMd1FroeGq.jpg"
},
{
"adult": false,
"gender": 2,
"id": 2461,
"known_for_department": "Acting",
"media_type": "person",
"name": "Mel Gibson",
"original_name": "Mel Gibson",
"popularity": 192.688,
"profile_path": "/jnqHMaOslt8cef2atSmOpGRvNla.jpg"
},
{
"adult": false,
"gender": 0,
"id": 1067215,
"known_for_department": "Acting",
"media_type": "person",
"name": "Yardar Parnsombat",
"original_name": "ญาดา ปานสมบัติ",
"popularity": 0.157,
"profile_path": null
},
{
"adult": false,
"gender": 1,
"id": 4153819,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jeong Yoon-I",
"original_name": "Jeong Yoon-I",
"popularity": 25.038,
"profile_path": "/zsIMMBDLYkAOM0LfziQR8hkc46M.jpg"
},
{
"adult": false,
"gender": 1,
"id": 2472212,
"known_for_department": "Acting",
"media_type": "person",
"name": "Sae Bom",
"original_name": "Sae Bom",
"popularity": 12.051,
"profile_path": "/mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg"
},
{
"adult": false,
"gender": 1,
"id": 5009979,
"known_for_department": null,
"media_type": "person",
"name": "河北彩花",
"original_name": "河北彩花",
"popularity": 7.213,
"profile_path": "/pDVfME2z2DiosnHFBALHvoSvqs5.jpg"
},
{
"adult": false,
"gender": 2,
"id": 11505,
"known_for_department": "Writing",
"media_type": "person",
"name": "John Hughes",
"original_name": "John Hughes",
"popularity": 25.555,
"profile_path": "/nfGhXH2zcGPAOw8kNbnes516aZG.jpg"
},
{
"adult": false,
"gender": 1,
"id": 2227,
"known_for_department": "Acting",
"media_type": "person",
"name": "Nicole Kidman",
"original_name": "Nicole Kidman",
"popularity": 107.888,
"profile_path": "/lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg"
},
{
"adult": false,
"gender": 1,
"id": 5009810,
"known_for_department": "Acting",
"media_type": "person",
"name": "河北彩花",
"original_name": "河北彩花",
"popularity": 5.565,
"profile_path": "/5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg"
},
{
"adult": false,
"gender": 2,
"id": 15111,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jean-Claude Van Damme",
"original_name": "Jean-Claude Van Damme",
"popularity": 84.447,
"profile_path": "/7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg"
},
{
"adult": false,
"gender": 2,
"id": 976,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jason Statham",
"original_name": "Jason Statham",
"popularity": 156.507,
"profile_path": "/whNwkEQYWLFJA8ij0WyOOAD5xhQ.jpg"
},
{
"adult": false,
"gender": 1,
"id": 1997928,
"known_for_department": "Acting",
"media_type": "person",
"name": "Jin Joo",
"original_name": "진주",
"popularity": 82.062,
"profile_path": "/awN0RgLUn0j8AsGsC4JNT1gdkVI.jpg"
},
{
"adult": false,
"gender": 1,
"id": 1622390,
"known_for_department": "Acting",
"media_type": "person",
"name": "Lee Chae-dam",
"original_name": "Lee Chae-dam",
"popularity": 23.379,
"profile_path": "/7wMyr6F3yzvbSpu2XMxSW3vObED.jpg"
},
{
"adult": false,
"gender": 1,
"id": 3165040,
"known_for_department": "Acting",
"media_type": "person",
"name": "Rika",
"original_name": "Rika",
"popularity": 77.329,
"profile_path": "/vwYqrhcSRVrnra4S0NopnywN8rK.jpg"
},
{
"adult": false,
"gender": 2,
"id": 6193,
"known_for_department": "Acting",
"media_type": "person",
"name": "Leonardo DiCaprio",
"original_name": "Leonardo DiCaprio",
"popularity": 119.894,
"profile_path": "/ts9l18VkDSooRGDWIeQegNVHciC.jpg"
},
{
"adult": false,
"gender": 2,
"id": 1269,
"known_for_department": "Acting",
"media_type": "person",
"name": "Kevin Costner",
"original_name": "Kevin Costner",
"popularity": 72.762,
"profile_path": "/608blZipRDZkDpzp8VItB64qMaT.jpg"
},
{
"adult": false,
"gender": 2,
"id": 2963,
"known_for_department": "Acting",
"media_type": "person",
"name": "Nicolas Cage",
"original_name": "Nicolas Cage",
"popularity": 95.498,
"profile_path": "/ar33qcWbEgREn07ZpXv5Pbj8hbM.jpg"
},
{
"adult": false,
"gender": 2,
"id": 1435525,
"known_for_department": "Directing",
"media_type": "person",
"name": "Jerry White Jr.",
"original_name": "Jerry White Jr.",
"popularity": 0.001,
"profile_path": "/ly85IL1VACCPSxaKtyBbFTBuWYB.jpg"
},
{
"adult": false,
"gender": 1,
"id": 204,
"known_for_department": "Acting",
"media_type": "person",
"name": "Kate Winslet",
"original_name": "Kate Winslet",
"popularity": 51.616,
"profile_path": "/e3tdop3WhseRnn8KwMVLAV25Ybv.jpg"
},
{
"adult": false,
"gender": 1,
"id": 25837,
"known_for_department": "Acting",
"media_type": "person",
"name": "Elisha Cuthbert",
"original_name": "Elisha Cuthbert",
"popularity": 67.77,
"profile_path": "/lsNwsJjGZqgjVUI1mhtcDCuwES3.jpg"
}
]
Example:
229
Example:
4577
⌘I