People

This endpoint get the trending people on TMDB.

GET /trending/person/{time_window}

People

cURL

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

200

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "id": 224513,
      "name": "Ana de Armas",
      "original_name": "Ana de Armas",
      "media_type": "person",
      "popularity": 349.766,
      "gender": 1,
      "known_for_department": "Acting",
      "profile_path": "/3vxvsmYLTf4jnr163SUlBIw51ee.jpg",
      "known_for": [
        {
          "adult": false,
          "backdrop_path": "/ilRyazdMJwN05exqhwK4tMKBYZs.jpg",
          "id": 335984,
          "title": "Blade Runner 2049",
          "original_language": "en",
          "original_title": "Blade Runner 2049",
          "overview": "Thirty years after the events of the first film, a new blade runner, LAPD Officer K, unearths a long-buried secret that has the potential to plunge what's left of society into chaos. K's discovery leads him on a quest to find Rick Deckard, a former LAPD blade runner who has been missing for 30 years.",
          "poster_path": "/gajva2L0rPYkEWjzgFlBXCAVBE5.jpg",
          "media_type": "movie",
          "genre_ids": [
            878,
            18
          ],
          "popularity": 79.571,
          "release_date": "2017-10-04",
          "video": false,
          "vote_average": 7.531,
          "vote_count": 11771
        },
        {
          "adult": false,
          "backdrop_path": "/4HWAQu28e2yaWrtupFPGFkdNU7V.jpg",
          "id": 546554,
          "title": "Knives Out",
          "original_language": "en",
          "original_title": "Knives Out",
          "overview": "When renowned crime novelist Harlan Thrombey is found dead at his estate just after his 85th birthday, the inquisitive and debonair Detective Benoit Blanc is mysteriously enlisted to investigate. From Harlan's dysfunctional family to his devoted staff, Blanc sifts through a web of red herrings and self-serving lies to uncover the truth behind Harlan's untimely death.",
          "poster_path": "/pThyQovXQrw2m0s9x82twj48Jq4.jpg",
          "media_type": "movie",
          "genre_ids": [
            35,
            80,
            9648
          ],
          "popularity": 52.748,
          "release_date": "2019-11-27",
          "video": false,
          "vote_average": 7.854,
          "vote_count": 10630
        },
        {
          "adult": false,
          "backdrop_path": "/3Mnbw4gOYz5BNZB9PhZ2cyBSQum.jpg",
          "id": 308266,
          "title": "War Dogs",
          "original_language": "en",
          "original_title": "War Dogs",
          "overview": "Based on the true story of two young men, David Packouz and Efraim Diveroli, who won a $300 million contract from the Pentagon to arm America's allies in Afghanistan.",
          "poster_path": "/uH9qGH5XS1iZXCSb3tgu40dxQoh.jpg",
          "media_type": "movie",
          "genre_ids": [
            35,
            80,
            18
          ],
          "popularity": 29.906,
          "release_date": "2016-08-17",
          "video": false,
          "vote_average": 6.892,
          "vote_count": 4324
        }
      ]
    },
    {
      "adult": false,
      "id": 1158,
      "name": "Al Pacino",
      "original_name": "Al Pacino",
      "media_type": "person",
      "popularity": 47.533,
      "gender": 2,
      "known_for_department": "Acting",
      "profile_path": "/fMDFeVf0pjopTJbyRSLFwNDm8Wr.jpg",
      "known_for": [
        {
          "adult": false,
          "backdrop_path": "/kGzFbGhp99zva6oZODW5atUtnqi.jpg",
          "id": 240,
          "title": "The Godfather Part II",
          "original_language": "en",
          "original_title": "The Godfather Part II",
          "overview": "In the continuing saga of the Corleone crime family, a young Vito Corleone grows up in Sicily and in 1910s New York. In the 1950s, Michael Corleone attempts to expand the family business into Las Vegas, Hollywood and Cuba.",
          "poster_path": "/hek3koDUyRQk7FIhPXsa6mT2Zc3.jpg",
          "media_type": "movie",
          "genre_ids": [
            18,
            80
          ],
          "popularity": 62.221,
          "release_date": "1974-12-20",
          "video": false,
          "vote_average": 8.597,
          "vote_count": 10775
        },
        {
          "adult": false,
          "backdrop_path": "/cCvp5Sni75agCtyJkNOMapORUQV.jpg",
          "id": 111,
          "title": "Scarface",
          "original_language": "en",
          "original_title": "Scarface",
          "overview": "After getting a green card in exchange for assassinating a Cuban government official, Tony Montana stakes a claim on the drug trade in Miami. Viciously murdering anyone who stands in his way, Tony eventually becomes the biggest drug lord in the state, controlling nearly all the cocaine that comes through Miami. But increased pressure from the police, wars with Colombian drug cartels and his own drug-fueled paranoia serve to fuel the flames of his eventual downfall.",
          "poster_path": "/iQ5ztdjvteGeboxtmRdXEChJOHh.jpg",
          "media_type": "movie",
          "genre_ids": [
            28,
            80,
            18
          ],
          "popularity": 76.345,
          "release_date": "1983-12-09",
          "video": false,
          "vote_average": 8.166,
          "vote_count": 10271
        },
        {
          "adult": false,
          "backdrop_path": "/tmU7GeKVybMWFButWEGl2M4GeiP.jpg",
          "id": 238,
          "title": "The Godfather",
          "original_language": "en",
          "original_title": "The Godfather",
          "overview": "Spanning the years 1945 to 1955, a chronicle of the fictional Italian-American Corleone crime family. When organized crime family patriarch, Vito Corleone barely survives an attempt on his life, his youngest son, Michael steps in to take care of the would-be killers, launching a campaign of bloody revenge.",
          "poster_path": "/3bhkrj58Vtu7enYsRolD1fZdja1.jpg",
          "media_type": "movie",
          "genre_ids": [
            18,
            80
          ],
          "popularity": 102.215,
          "release_date": "1972-03-14",
          "video": false,
          "vote_average": 8.712,
          "vote_count": 17806
        }
      ]
    },
    {
      "adult": false,
      "id": 57607,
      "name": "Stephen Chow",
      "original_name": "Stephen Chow",
      "media_type": "person",
      "popularity": 23.539,
      "gender": 2,
      "known_for_department": "Acting",
      "profile_path": "/qPGmIuQ3DKzzpZy5Y12WeoOUijV.jpg",
      "known_for": [
        {
          "adult": false,
          "backdrop_path": "/z8eKIdNRbTmCLpFoZqTQvN4wdEM.jpg",
          "id": 9470,
          "title": "Kung Fu Hustle",
          "original_language": "cn",
          "original_title": "功夫",
          "overview": "It's the 1940s, and the notorious Axe Gang terrorizes Shanghai. Small-time criminals Sing and Bone hope to join, but they only manage to make lots of very dangerous enemies. Fortunately for them, kung fu masters and hidden strength can be found in unlikely places. Now they just have to take on the entire Axe Gang.",
          "poster_path": "/exbyTbrvRUDKN2mcNEuVor4VFQW.jpg",
          "media_type": "movie",
          "genre_ids": [
            28,
            35,
            80,
            14
          ],
          "popularity": 24.234,
          "release_date": "2004-02-10",
          "video": false,
          "vote_average": 7.402,
          "vote_count": 2394
        },
        {
          "adult": false,
          "backdrop_path": "/tkxYmE3HzHy7E39zY3VvQ0k0VLU.jpg",
          "id": 11770,
          "title": "Shaolin Soccer",
          "original_language": "cn",
          "original_title": "少林足球",
          "overview": "A young Shaolin follower reunites with his discouraged brothers to form a soccer team using their martial art skills to their advantage.",
          "poster_path": "/kVpq68NxChzynK7otaymRSaWR8p.jpg",
          "media_type": "movie",
          "genre_ids": [
            28,
            35
          ],
          "popularity": 35.178,
          "release_date": "2001-07-05",
          "video": false,
          "vote_average": 7.072,
          "vote_count": 1884
        },
        {
          "adult": false,
          "backdrop_path": "/iKUwhA4DUxMcNKu5lLSbDFwwilk.jpg",
          "id": 453395,
          "title": "Doctor Strange in the Multiverse of Madness",
          "original_language": "en",
          "original_title": "Doctor Strange in the Multiverse of Madness",
          "overview": "Doctor Strange, with the help of mystical allies both old and new, traverses the mind-bending and dangerous alternate realities of the Multiverse to confront a mysterious new adversary.",
          "poster_path": "/9Gtg2DzBhmYamXBS1hKAhiwbBKS.jpg",
          "media_type": "movie",
          "genre_ids": [
            14,
            28,
            12
          ],
          "popularity": 266.886,
          "release_date": "2022-05-04",
          "video": false,
          "vote_average": 7.383,
          "vote_count": 7322
        }
      ]
    }
  ],
  "total_pages": 1000,
  "total_results": 20000
}

Authorizations

Authorization · string · header · required

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

Path Parameters

time_window · string · required

Day

Query Parameters

language · string

Defaults to en-US

Response

200 - application/json

Successful

page · integer

Indicates the current page number

results · object[]

Contains the list of data or items

Show child attributes

total_pages · integer

Specifies the total number of pages available

total_results · integer

Represents the total number of items or records in a dataset