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

The response is of type object.