People - API documentation

People

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

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))

}

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": 17276,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Gerard Butler",
      "original_name": "Gerard Butler",
      "popularity": 55.612,
      "profile_path": "/rTO5opVC3Gs6hPYAxWSP9eEjogi.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1908004,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Sang Woo",
      "original_name": "상우",
      "popularity": 2.401,
      "profile_path": "/lLGmnCeUVsVAS6Q4GvhiMFXuI8L.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 589340,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Huang Yi",
      "original_name": "黄奕",
      "popularity": 8.248,
      "profile_path": "/AZMBqGQOmNqb6ScgunLhC5KNdW.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 1974009,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Kim Do-hee",
      "original_name": "Kim Do-hee",
      "popularity": 64.816,
      "profile_path": "/vDK2YCaePyUO4bxTE5mbvQqdqwp.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 2710789,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Seung Ha",
      "original_name": "채승하",
      "popularity": 30.942,
      "profile_path": "/nvSJiHakYrDa3CedKSVOEsbLLX8.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 18897,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Jackie Chan",
      "original_name": "成龍",
      "popularity": 90.474,
      "profile_path": "/nraZoTzwJQPHspAVsKfgl3RXKKa.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 5009810,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "河北彩花",
      "original_name": "河北彩花",
      "popularity": 5.295,
      "profile_path": "/5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1019,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Mads Mikkelsen",
      "original_name": "Mads Mikkelsen",
      "popularity": 73.19,
      "profile_path": "/ntwPvV4GKGGHO3I7LcHMwhXfsw9.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 5009979,
      "known_for_department": null,
      "media_type": "person",
      "name": "河北彩花",
      "original_name": "河北彩花",
      "popularity": 7.433,
      "profile_path": "/pDVfME2z2DiosnHFBALHvoSvqs5.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 488,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Steven Spielberg",
      "original_name": "Steven Spielberg",
      "popularity": 45.486,
      "profile_path": "/tZxcg19YQ3e8fJ0pOs7hjlnmmr6.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 224513,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Ana de Armas",
      "original_name": "Ana de Armas",
      "popularity": 138.067,
      "profile_path": "/5Qne374OM0ewMM7uSN9eq9jNrWq.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 1622390,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Lee Chae-dam",
      "original_name": "Lee Chae-dam",
      "popularity": 22.754,
      "profile_path": "/7wMyr6F3yzvbSpu2XMxSW3vObED.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 287,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Brad Pitt",
      "original_name": "Brad Pitt",
      "popularity": 68.057,
      "profile_path": "/4rjnRCQ6bGFYdBb4UooOjsQy12c.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 2227,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Nicole Kidman",
      "original_name": "Nicole Kidman",
      "popularity": 72.579,
      "profile_path": "/lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg"
    },
    {
      "adult": false,
      "gender": 0,
      "id": 4624919,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Angel Alvarez",
      "original_name": "Angel Alvarez",
      "popularity": 0.001,
      "profile_path": null
    },
    {
      "adult": false,
      "gender": 2,
      "id": 17884,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Jeff Baena",
      "original_name": "Jeff Baena",
      "popularity": 2.08,
      "profile_path": "/eOdq8CVGTQ9aba9coTzHQZp6MM2.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 525,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Christopher Nolan",
      "original_name": "Christopher Nolan",
      "popularity": 46.211,
      "profile_path": "/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 2359937,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Jo Yu-ri",
      "original_name": "조유리",
      "popularity": 41.496,
      "profile_path": "/uv9CSDBOPhpOn494P4oZTsk4J5J.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 62,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Bruce Willis",
      "original_name": "Bruce Willis",
      "popularity": 63.638,
      "profile_path": "/w3aXr1e7gQCn8MSp1vW4sXHn99P.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1664920,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Oh Soon-tae",
      "original_name": "오순태",
      "popularity": 0.001,
      "profile_path": "/deE937OZKgXGRky9LJMTtujy8KQ.jpg"
    }
  ],
  "total_pages": 266,
  "total_results": 5304
}

GET

trending

person

{time_window}

People

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

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))

}

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": 17276,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Gerard Butler",
      "original_name": "Gerard Butler",
      "popularity": 55.612,
      "profile_path": "/rTO5opVC3Gs6hPYAxWSP9eEjogi.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1908004,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Sang Woo",
      "original_name": "상우",
      "popularity": 2.401,
      "profile_path": "/lLGmnCeUVsVAS6Q4GvhiMFXuI8L.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 589340,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Huang Yi",
      "original_name": "黄奕",
      "popularity": 8.248,
      "profile_path": "/AZMBqGQOmNqb6ScgunLhC5KNdW.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 1974009,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Kim Do-hee",
      "original_name": "Kim Do-hee",
      "popularity": 64.816,
      "profile_path": "/vDK2YCaePyUO4bxTE5mbvQqdqwp.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 2710789,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Seung Ha",
      "original_name": "채승하",
      "popularity": 30.942,
      "profile_path": "/nvSJiHakYrDa3CedKSVOEsbLLX8.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 18897,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Jackie Chan",
      "original_name": "成龍",
      "popularity": 90.474,
      "profile_path": "/nraZoTzwJQPHspAVsKfgl3RXKKa.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 5009810,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "河北彩花",
      "original_name": "河北彩花",
      "popularity": 5.295,
      "profile_path": "/5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1019,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Mads Mikkelsen",
      "original_name": "Mads Mikkelsen",
      "popularity": 73.19,
      "profile_path": "/ntwPvV4GKGGHO3I7LcHMwhXfsw9.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 5009979,
      "known_for_department": null,
      "media_type": "person",
      "name": "河北彩花",
      "original_name": "河北彩花",
      "popularity": 7.433,
      "profile_path": "/pDVfME2z2DiosnHFBALHvoSvqs5.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 488,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Steven Spielberg",
      "original_name": "Steven Spielberg",
      "popularity": 45.486,
      "profile_path": "/tZxcg19YQ3e8fJ0pOs7hjlnmmr6.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 224513,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Ana de Armas",
      "original_name": "Ana de Armas",
      "popularity": 138.067,
      "profile_path": "/5Qne374OM0ewMM7uSN9eq9jNrWq.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 1622390,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Lee Chae-dam",
      "original_name": "Lee Chae-dam",
      "popularity": 22.754,
      "profile_path": "/7wMyr6F3yzvbSpu2XMxSW3vObED.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 287,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Brad Pitt",
      "original_name": "Brad Pitt",
      "popularity": 68.057,
      "profile_path": "/4rjnRCQ6bGFYdBb4UooOjsQy12c.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 2227,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Nicole Kidman",
      "original_name": "Nicole Kidman",
      "popularity": 72.579,
      "profile_path": "/lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg"
    },
    {
      "adult": false,
      "gender": 0,
      "id": 4624919,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Angel Alvarez",
      "original_name": "Angel Alvarez",
      "popularity": 0.001,
      "profile_path": null
    },
    {
      "adult": false,
      "gender": 2,
      "id": 17884,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Jeff Baena",
      "original_name": "Jeff Baena",
      "popularity": 2.08,
      "profile_path": "/eOdq8CVGTQ9aba9coTzHQZp6MM2.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 525,
      "known_for_department": "Directing",
      "media_type": "person",
      "name": "Christopher Nolan",
      "original_name": "Christopher Nolan",
      "popularity": 46.211,
      "profile_path": "/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg"
    },
    {
      "adult": false,
      "gender": 1,
      "id": 2359937,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Jo Yu-ri",
      "original_name": "조유리",
      "popularity": 41.496,
      "profile_path": "/uv9CSDBOPhpOn494P4oZTsk4J5J.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 62,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Bruce Willis",
      "original_name": "Bruce Willis",
      "popularity": 63.638,
      "profile_path": "/w3aXr1e7gQCn8MSp1vW4sXHn99P.jpg"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1664920,
      "known_for_department": "Acting",
      "media_type": "person",
      "name": "Oh Soon-tae",
      "original_name": "오순태",
      "popularity": 0.001,
      "profile_path": "/deE937OZKgXGRky9LJMTtujy8KQ.jpg"
    }
  ],
  "total_pages": 266,
  "total_results": 5304
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

time_window

enum<string>

required

It allows users to specify whether they want to receive trending data for a single day ("day") or for the entire week ("week").

Available options:

day,

week

Example:

"day"

Query Parameters

language

string

Specifies the language in which the response should be returned.

Example:

"en-US"

Response

200 - application/json

people

page

number

Example:

1

results

object[]

Show child attributes

Example:

[
  {
    "adult": false,
    "gender": 2,
    "id": 17276,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Gerard Butler",
    "original_name": "Gerard Butler",
    "popularity": 55.612,
    "profile_path": "/rTO5opVC3Gs6hPYAxWSP9eEjogi.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 1908004,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Sang Woo",
    "original_name": "상우",
    "popularity": 2.401,
    "profile_path": "/lLGmnCeUVsVAS6Q4GvhiMFXuI8L.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 589340,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Huang Yi",
    "original_name": "黄奕",
    "popularity": 8.248,
    "profile_path": "/AZMBqGQOmNqb6ScgunLhC5KNdW.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 1974009,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Kim Do-hee",
    "original_name": "Kim Do-hee",
    "popularity": 64.816,
    "profile_path": "/vDK2YCaePyUO4bxTE5mbvQqdqwp.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 2710789,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Seung Ha",
    "original_name": "채승하",
    "popularity": 30.942,
    "profile_path": "/nvSJiHakYrDa3CedKSVOEsbLLX8.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 18897,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Jackie Chan",
    "original_name": "成龍",
    "popularity": 90.474,
    "profile_path": "/nraZoTzwJQPHspAVsKfgl3RXKKa.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 5009810,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "河北彩花",
    "original_name": "河北彩花",
    "popularity": 5.295,
    "profile_path": "/5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 1019,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Mads Mikkelsen",
    "original_name": "Mads Mikkelsen",
    "popularity": 73.19,
    "profile_path": "/ntwPvV4GKGGHO3I7LcHMwhXfsw9.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 5009979,
    "known_for_department": null,
    "media_type": "person",
    "name": "河北彩花",
    "original_name": "河北彩花",
    "popularity": 7.433,
    "profile_path": "/pDVfME2z2DiosnHFBALHvoSvqs5.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 488,
    "known_for_department": "Directing",
    "media_type": "person",
    "name": "Steven Spielberg",
    "original_name": "Steven Spielberg",
    "popularity": 45.486,
    "profile_path": "/tZxcg19YQ3e8fJ0pOs7hjlnmmr6.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 224513,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Ana de Armas",
    "original_name": "Ana de Armas",
    "popularity": 138.067,
    "profile_path": "/5Qne374OM0ewMM7uSN9eq9jNrWq.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 1622390,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Lee Chae-dam",
    "original_name": "Lee Chae-dam",
    "popularity": 22.754,
    "profile_path": "/7wMyr6F3yzvbSpu2XMxSW3vObED.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 287,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Brad Pitt",
    "original_name": "Brad Pitt",
    "popularity": 68.057,
    "profile_path": "/4rjnRCQ6bGFYdBb4UooOjsQy12c.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 2227,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Nicole Kidman",
    "original_name": "Nicole Kidman",
    "popularity": 72.579,
    "profile_path": "/lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg"
  },
  {
    "adult": false,
    "gender": 0,
    "id": 4624919,
    "known_for_department": "Directing",
    "media_type": "person",
    "name": "Angel Alvarez",
    "original_name": "Angel Alvarez",
    "popularity": 0.001,
    "profile_path": null
  },
  {
    "adult": false,
    "gender": 2,
    "id": 17884,
    "known_for_department": "Directing",
    "media_type": "person",
    "name": "Jeff Baena",
    "original_name": "Jeff Baena",
    "popularity": 2.08,
    "profile_path": "/eOdq8CVGTQ9aba9coTzHQZp6MM2.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 525,
    "known_for_department": "Directing",
    "media_type": "person",
    "name": "Christopher Nolan",
    "original_name": "Christopher Nolan",
    "popularity": 46.211,
    "profile_path": "/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg"
  },
  {
    "adult": false,
    "gender": 1,
    "id": 2359937,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Jo Yu-ri",
    "original_name": "조유리",
    "popularity": 41.496,
    "profile_path": "/uv9CSDBOPhpOn494P4oZTsk4J5J.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 62,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Bruce Willis",
    "original_name": "Bruce Willis",
    "popularity": 63.638,
    "profile_path": "/w3aXr1e7gQCn8MSp1vW4sXHn99P.jpg"
  },
  {
    "adult": false,
    "gender": 2,
    "id": 1664920,
    "known_for_department": "Acting",
    "media_type": "person",
    "name": "Oh Soon-tae",
    "original_name": "오순태",
    "popularity": 0.001,
    "profile_path": "/deE937OZKgXGRky9LJMTtujy8KQ.jpg"
  }
]

total_pages

number

Example:

266

total_results

number

Example:

5304