> ## Documentation Index > Fetch the complete documentation index at: https://chisa.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # People > Get the trending people on TMDB. ## OpenAPI ````yaml api-reference/openapi.json get /3/trending/person/{{time_window}} openapi: 3.0.3 info: title: Themoviedb API description: >- Version 3 (stable) of The Movie Database (TMDB) API offers a concise list of available methods for movies, TV shows, actors, and images. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org - url: https://api.themoviedb.org/3 security: [] tags: - name: Account - name: Authentication description: >- # How do I generate a session id? As outlined in the [getting started guide](https://developer.themoviedb.org/docs/getting-started), the basics to getting a user authenticated look like this: 1. **Create a new request token** 2. **Get the user to authorize the request token** 3. **Create a new session id with the authorized request token** Steps 1 and 3 should be fairly easy to understand, but let's walk through each to ensure clarity. ## Step 1: Create a request token The first step as a developer is to request a new token. This is a **temporary token** required to ask the user for permission to access their account. This token will automatically expire **after 60 minutes** if it's not used. ## Step 2: Ask the user for permission With a request token in hand, forward your user to the following URL: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN} ``` You can also pass this URL a `redirect_to` parameter, like so: ``` https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}?redirect_to=http://www.yourapp.com/approved ``` Once the user has approved your request token, they will either be redirected to the URL you specified in the `redirect_to` parameter or to the `/authenticate/allow` path on TMDB. If they aren't redirected to a custom URL, the page will also include an `Authentication-Callback` header. This header contains the API call for step #3. You can either manually generate it or simply use the one we return. ## Step 3: Create a session ID By calling the **new session method** with the request token that has been approved by the user in Step 2, we will return a **new session_id**. This session can now be used to write user data. You should treat this key **like a password** and keep it secret. ## What about guest sessions? A **guest session** can be used to rate movies **without** requiring a registered TMDB user account. For more information about how to create a guest session, see [here](https://developer.themoviedb.org/docs/authentication). - name: Certification - name: Changes - name: Collections - name: Companies - name: Configuration - name: Credits - name: Discover - name: Find - name: Genres - name: Guest Session - name: Keywords - name: List description: >- ## v3 or v4 list? 😕 You may have noticed that the a v4 version of our list API exists. While these v3 list methods continue to work, all of the new features you can see on our website are only available if you switch to the v4 lists. **What are some of the improvements in v4?** - You can import "unlimited" items in a single request - You can use mixed type (movie and TV) lists - You can use private lists - You can add and use comments per item - There are more sort options - They are faster - Check the v4 documentation for more information. - name: Movie Lists - name: Movies - name: Networks - name: People Lists - name: People - name: Reviews - name: Search - name: Trending - name: TV Series Lists - name: TV Series - name: TV Seasons - name: TV Episodes - name: TV Episode Groups - name: Watch Providers paths: /3/trending/person/{{time_window}}: parameters: - name: time_window in: path required: true schema: type: string get: tags: - Trending summary: People description: Get the trending people on TMDB. operationId: people parameters: - name: language in: query schema: type: string example: en-US responses: '200': description: People headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=317 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 10 Jan 2025 20:21:38 GMT ETag: schema: type: string example: W/"ba1733b79badedc75d4e07d4307267c1" Server: schema: type: string example: openresty Transfer-Encoding: schema: type: string example: chunked Vary: schema: type: string example: Origin Via: schema: type: string example: >- 1.1 7e9e069e30b25fca38d3949c59e59802.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: xpMNTu9ASfNoF30q023hRCiz_vWNgFWp3RhIzeUM-UBMeN9o1rs-uA== X-Amz-Cf-Pop: schema: type: string example: LOS50-P2 X-Cache: schema: type: string example: Miss from cloudfront x-memc: schema: type: string example: HIT x-memc-age: schema: type: string example: '283' x-memc-expires: schema: type: string example: '317' x-memc-key: schema: type: string example: 5715222b79a36893c5ffe4226981bbbc content: application/json: schema: type: object properties: page: type: number example: 1 results: type: array items: type: object properties: adult: type: boolean example: false gender: type: number example: 1 id: type: number example: 5009979 known_for_department: type: string nullable: true example: null media_type: type: string example: person name: type: string example: 河北彩花 original_name: type: string example: 河北彩花 popularity: type: number example: 6.81 profile_path: type: string nullable: true example: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg example: - adult: false gender: 1 id: 5009979 known_for_department: null media_type: person name: 河北彩花 original_name: 河北彩花 popularity: 6.81 profile_path: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg - adult: false gender: 2 id: 287 known_for_department: Acting media_type: person name: Brad Pitt original_name: Brad Pitt popularity: 82.25 profile_path: /ajNaPmXVVMJFg9GWmu6MJzTaXdV.jpg - adult: false gender: 1 id: 5009810 known_for_department: Acting media_type: person name: 河北彩花 original_name: 河北彩花 popularity: 5.832 profile_path: /5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg - adult: false gender: 1 id: 3164807 known_for_department: Acting media_type: person name: Yoon Yool original_name: Yoon Yool popularity: 88.418 profile_path: /21kdujBeL2hrJ50RyMxmuEsHZAT.jpg - adult: false gender: 1 id: 1647345 known_for_department: Acting media_type: person name: Lee Eun-mi original_name: Lee Eun-mi popularity: 7.214 profile_path: /dMKEjZYPAbATFSJfWaHoIW5hpOJ.jpg - adult: false gender: 1 id: 115440 known_for_department: Acting media_type: person name: Sydney Sweeney original_name: Sydney Sweeney popularity: 165.988 profile_path: /qYiaSl0Eb7G3VaxOg8PxExCFwon.jpg - adult: false gender: 2 id: 2461 known_for_department: Acting media_type: person name: Mel Gibson original_name: Mel Gibson popularity: 98.31 profile_path: /jnqHMaOslt8cef2atSmOpGRvNla.jpg - adult: false gender: 2 id: 500 known_for_department: Acting media_type: person name: Tom Cruise original_name: Tom Cruise popularity: 156.754 profile_path: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg - adult: false gender: 2 id: 206 known_for_department: Acting media_type: person name: Jim Carrey original_name: Jim Carrey popularity: 81.625 profile_path: /u0AqTz6Y7GHPCHINS01P7gPvDSb.jpg - adult: false gender: 2 id: 525 known_for_department: Directing media_type: person name: Christopher Nolan original_name: Christopher Nolan popularity: 74.258 profile_path: /xuAIuYSmsUzKlUMBFGVZaWsY3DZ.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.955 profile_path: /7wMyr6F3yzvbSpu2XMxSW3vObED.jpg - adult: false gender: 2 id: 1269 known_for_department: Acting media_type: person name: Kevin Costner original_name: Kevin Costner popularity: 68.02 profile_path: /608blZipRDZkDpzp8VItB64qMaT.jpg - adult: false gender: 2 id: 6384 known_for_department: Acting media_type: person name: Keanu Reeves original_name: Keanu Reeves popularity: 156.423 profile_path: /8RZLOyYGsoRe9p44q3xin9QkMHv.jpg - adult: false gender: 0 id: 5121818 known_for_department: Sound media_type: person name: Natalie Leggett original_name: Natalie Leggett popularity: 2.499 profile_path: null - adult: false gender: 2 id: 16483 known_for_department: Acting media_type: person name: Sylvester Stallone original_name: Sylvester Stallone popularity: 88.178 profile_path: /gn3pDWthJqR0VDYGViGD3048og7.jpg - adult: false gender: 1 id: 1708576 known_for_department: Acting media_type: person name: Ahn So-hee original_name: Ahn So-hee popularity: 32.911 profile_path: /7OWRPTEPYi7dV5a97fhXLiiHpPM.jpg - adult: false gender: 2 id: 18897 known_for_department: Acting media_type: person name: Jackie Chan original_name: 成龍 popularity: 111.308 profile_path: /nraZoTzwJQPHspAVsKfgl3RXKKa.jpg - adult: false gender: 2 id: 488 known_for_department: Directing media_type: person name: Steven Spielberg original_name: Steven Spielberg popularity: 52.647 profile_path: /tZxcg19YQ3e8fJ0pOs7hjlnmmr6.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: 68.078 profile_path: /7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg - adult: false gender: 1 id: 1702040 known_for_department: Acting media_type: person name: Han Se-hee original_name: Han Se-hee popularity: 26.139 profile_path: /aOzgGk5W9rM5kc5FDNcDkDfK7jd.jpg total_pages: type: number example: 500 total_results: type: number example: 10000 examples: People: value: page: 1 results: - adult: false gender: 1 id: 5009979 known_for_department: null media_type: person name: 河北彩花 original_name: 河北彩花 popularity: 6.81 profile_path: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg - adult: false gender: 2 id: 287 known_for_department: Acting media_type: person name: Brad Pitt original_name: Brad Pitt popularity: 82.25 profile_path: /ajNaPmXVVMJFg9GWmu6MJzTaXdV.jpg - adult: false gender: 1 id: 5009810 known_for_department: Acting media_type: person name: 河北彩花 original_name: 河北彩花 popularity: 5.832 profile_path: /5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg - adult: false gender: 1 id: 3164807 known_for_department: Acting media_type: person name: Yoon Yool original_name: Yoon Yool popularity: 88.418 profile_path: /21kdujBeL2hrJ50RyMxmuEsHZAT.jpg - adult: false gender: 1 id: 1647345 known_for_department: Acting media_type: person name: Lee Eun-mi original_name: Lee Eun-mi popularity: 7.214 profile_path: /dMKEjZYPAbATFSJfWaHoIW5hpOJ.jpg - adult: false gender: 1 id: 115440 known_for_department: Acting media_type: person name: Sydney Sweeney original_name: Sydney Sweeney popularity: 165.988 profile_path: /qYiaSl0Eb7G3VaxOg8PxExCFwon.jpg - adult: false gender: 2 id: 2461 known_for_department: Acting media_type: person name: Mel Gibson original_name: Mel Gibson popularity: 98.31 profile_path: /jnqHMaOslt8cef2atSmOpGRvNla.jpg - adult: false gender: 2 id: 500 known_for_department: Acting media_type: person name: Tom Cruise original_name: Tom Cruise popularity: 156.754 profile_path: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg - adult: false gender: 2 id: 206 known_for_department: Acting media_type: person name: Jim Carrey original_name: Jim Carrey popularity: 81.625 profile_path: /u0AqTz6Y7GHPCHINS01P7gPvDSb.jpg - adult: false gender: 2 id: 525 known_for_department: Directing media_type: person name: Christopher Nolan original_name: Christopher Nolan popularity: 74.258 profile_path: /xuAIuYSmsUzKlUMBFGVZaWsY3DZ.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.955 profile_path: /7wMyr6F3yzvbSpu2XMxSW3vObED.jpg - adult: false gender: 2 id: 1269 known_for_department: Acting media_type: person name: Kevin Costner original_name: Kevin Costner popularity: 68.02 profile_path: /608blZipRDZkDpzp8VItB64qMaT.jpg - adult: false gender: 2 id: 6384 known_for_department: Acting media_type: person name: Keanu Reeves original_name: Keanu Reeves popularity: 156.423 profile_path: /8RZLOyYGsoRe9p44q3xin9QkMHv.jpg - adult: false gender: 0 id: 5121818 known_for_department: Sound media_type: person name: Natalie Leggett original_name: Natalie Leggett popularity: 2.499 profile_path: null - adult: false gender: 2 id: 16483 known_for_department: Acting media_type: person name: Sylvester Stallone original_name: Sylvester Stallone popularity: 88.178 profile_path: /gn3pDWthJqR0VDYGViGD3048og7.jpg - adult: false gender: 1 id: 1708576 known_for_department: Acting media_type: person name: Ahn So-hee original_name: Ahn So-hee popularity: 32.911 profile_path: /7OWRPTEPYi7dV5a97fhXLiiHpPM.jpg - adult: false gender: 2 id: 18897 known_for_department: Acting media_type: person name: Jackie Chan original_name: 成龍 popularity: 111.308 profile_path: /nraZoTzwJQPHspAVsKfgl3RXKKa.jpg - adult: false gender: 2 id: 488 known_for_department: Directing media_type: person name: Steven Spielberg original_name: Steven Spielberg popularity: 52.647 profile_path: /tZxcg19YQ3e8fJ0pOs7hjlnmmr6.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: 68.078 profile_path: /7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg - adult: false gender: 1 id: 1702040 known_for_department: Acting media_type: person name: Han Se-hee original_name: Han Se-hee popularity: 26.139 profile_path: /aOzgGk5W9rM5kc5FDNcDkDfK7jd.jpg total_pages: 500 total_results: 10000 ````