GET
/
3
/
trending
/
person
/
{time_window}
People
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

page
number
Example:

1

results
object[]
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