> ## Documentation Index
> Fetch the complete documentation index at: https://starlight.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# People

> This endpoint retrieves a list of all popular people on TMDB.



## OpenAPI

````yaml api-reference/openapi.yaml get /3/trending/person/{{time_window}}
openapi: 3.0.3
info:
  title: The Movie Database API
  description: >-
    Welcome to the third version of The Movie Database (TMDB) API. Our API
    provides you with vast access to a range of movies, TV shows, actor
    information, and images.


    With the TMDB API, you can easily integrate any of these functionalities in
    your application.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
  - url: Collection
security:
  - bearerAuth: []
tags:
  - name: Validate Key
  - name: Authentication
  - name: Guest Sessions
  - name: Configuration
  - name: Account
  - name: Search
  - name: Discover
  - name: Find
  - name: Keyword
  - name: Lists
  - name: V3 vs V4
    description: >-
      There is version 4 (v4) for our list API. It contains several advanced
      improvements that differentiate it from the version 3 (v3) list. Although
      v3 lists will continue to work, you can only access these features if you
      switch to v4 lists.


      Some of the new improvements you can access on v4 lists include:


      - 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
      ](https://developer.themoviedb.org/v4/docs/getting-started) for more
      information.  
  - name: Collections
  - name: Companies
  - name: Networks
  - name: Trending
  - name: Movies
  - name: Movie Lists
  - name: TV Series
  - name: TV Series Lists
  - name: TV Seasons
  - name: TV Providers
  - name: TV Episode Groups
  - name: Watch Providers
  - name: People
  - name: People List
  - name: Genre
  - name: Changes
  - name: Credits
  - name: Certifications
paths:
  /3/trending/person/{{time_window}}:
    parameters:
      - name: time_window
        in: path
        description: This represents the time window.
        required: true
        schema:
          type: string
          enum:
            - day
            - week
    get:
      tags:
        - Trending
      summary: People
      description: This endpoint retrieves a list of all popular people on TMDB.
      operationId: people
      parameters:
        - name: language
          in: query
          schema:
            type: string
            example: en
          description: This represents the language.
      responses:
        '200':
          description: People
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=321
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sat, 28 Dec 2024 13:49:49 GMT
            ETag:
              schema:
                type: string
                example: W/"e1860a2074dde4e71e30a17c737d91ca"
            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 c35f767218cbd1125d801b52fa785c8c.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: GIHauRbI_OSCBfRo_sBB1Vak5xGQnlIQUJdvZLYvKB5q1heG_ujXfg==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: IAD89-C3
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: HIT
            x-memc-age:
              schema:
                type: string
                example: '279'
            x-memc-expires:
              schema:
                type: string
                example: '321'
            x-memc-key:
              schema:
                type: string
                example: 8e3076d3ff2399ed6f663a07a0d73a89
          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: 2
                        id:
                          type: number
                          example: 525
                        known_for_department:
                          type: string
                          nullable: true
                          example: Directing
                        media_type:
                          type: string
                          example: person
                        name:
                          type: string
                          example: Christopher Nolan
                        original_name:
                          type: string
                          example: Christopher Nolan
                        popularity:
                          type: number
                          example: 49.577
                        profile_path:
                          type: string
                          nullable: true
                          example: /xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg
                    example:
                      - adult: false
                        gender: 2
                        id: 525
                        known_for_department: Directing
                        media_type: person
                        name: Christopher Nolan
                        original_name: Christopher Nolan
                        popularity: 49.577
                        profile_path: /xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg
                      - adult: false
                        gender: 1
                        id: 5009979
                        known_for_department: null
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 5.817
                        profile_path: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg
                      - adult: false
                        gender: 2
                        id: 4173
                        known_for_department: Acting
                        media_type: person
                        name: Anthony Hopkins
                        original_name: Anthony Hopkins
                        popularity: 44.113
                        profile_path: /iaf7SHSkGDpnyrDh1Jolilwk2TD.jpg
                      - adult: false
                        gender: 2
                        id: 1190668
                        known_for_department: Acting
                        media_type: person
                        name: Timothée Chalamet
                        original_name: Timothée Chalamet
                        popularity: 129.501
                        profile_path: /BE2sdjpgsa2rNTFa66f7upkaOP.jpg
                      - adult: false
                        gender: 2
                        id: 16483
                        known_for_department: Acting
                        media_type: person
                        name: Sylvester Stallone
                        original_name: Sylvester Stallone
                        popularity: 88.773
                        profile_path: /gn3pDWthJqR0VDYGViGD3048og7.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.362
                        profile_path: /7wMyr6F3yzvbSpu2XMxSW3vObED.jpg
                      - adult: false
                        gender: 1
                        id: 5009810
                        known_for_department: Acting
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 4.131
                        profile_path: /5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg
                      - adult: false
                        gender: 2
                        id: 190
                        known_for_department: Acting
                        media_type: person
                        name: Clint Eastwood
                        original_name: Clint Eastwood
                        popularity: 45.796
                        profile_path: /8TwdCfeOZH7ucRlfLZ6wObxa7cO.jpg
                      - adult: false
                        gender: 2
                        id: 500
                        known_for_department: Acting
                        media_type: person
                        name: Tom Cruise
                        original_name: Tom Cruise
                        popularity: 104.369
                        profile_path: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg
                      - adult: false
                        gender: 0
                        id: 31912
                        known_for_department: Visual Effects
                        media_type: person
                        name: Andy Williams
                        original_name: Andy Williams
                        popularity: 0.001
                        profile_path: null
                      - adult: false
                        gender: 1
                        id: 2710789
                        known_for_department: Acting
                        media_type: person
                        name: Seung Ha
                        original_name: 채승하
                        popularity: 28.611
                        profile_path: /nvSJiHakYrDa3CedKSVOEsbLLX8.jpg
                      - adult: false
                        gender: 0
                        id: 5121818
                        known_for_department: Sound
                        media_type: person
                        name: Natalie Leggett
                        original_name: Natalie Leggett
                        popularity: 2.165
                        profile_path: null
                      - adult: false
                        gender: 2
                        id: 30614
                        known_for_department: Acting
                        media_type: person
                        name: Ryan Gosling
                        original_name: Ryan Gosling
                        popularity: 64.885
                        profile_path: /4X1wJo5xHm3YICPWZqVCPgLBEJ7.jpg
                      - adult: false
                        gender: 2
                        id: 3583157
                        known_for_department: Sound
                        media_type: person
                        name: Naoyuki Chikatani
                        original_name: 近谷直之
                        popularity: 0.001
                        profile_path: null
                      - adult: false
                        gender: 1
                        id: 1287869
                        known_for_department: Costume & Make-Up
                        media_type: person
                        name: Kelly Golden
                        original_name: Kelly Golden
                        popularity: 1.848
                        profile_path: null
                      - adult: false
                        gender: 2
                        id: 19292
                        known_for_department: Acting
                        media_type: person
                        name: Adam Sandler
                        original_name: Adam Sandler
                        popularity: 48.484
                        profile_path: /1xVMlB2Ufj8MtXzZkfQlPoadRMm.jpg
                      - adult: false
                        gender: 1
                        id: 3194176
                        known_for_department: Acting
                        media_type: person
                        name: Angeli Khang
                        original_name: Angeli Khang
                        popularity: 32.213
                        profile_path: /7vrTWF8PxQogF6o9ORZprYQoDOr.jpg
                      - adult: false
                        gender: 2
                        id: 10850
                        known_for_department: Production
                        media_type: person
                        name: Kevin Feige
                        original_name: Kevin Feige
                        popularity: 21.199
                        profile_path: /2XZT80gR72to084pEj4f0SCDmDn.jpg
                      - adult: false
                        gender: 2
                        id: 8891
                        known_for_department: Acting
                        media_type: person
                        name: John Travolta
                        original_name: John Travolta
                        popularity: 31.434
                        profile_path: /JSt3skdZpGPJYJixCZqH599WdI.jpg
                      - adult: false
                        gender: 1
                        id: 2472212
                        known_for_department: Acting
                        media_type: person
                        name: Sae Bom
                        original_name: Sae Bom
                        popularity: 8.595
                        profile_path: /mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg
                  total_pages:
                    type: number
                    example: 234
                  total_results:
                    type: number
                    example: 4672
              examples:
                People:
                  value:
                    page: 1
                    results:
                      - adult: false
                        gender: 2
                        id: 525
                        known_for_department: Directing
                        media_type: person
                        name: Christopher Nolan
                        original_name: Christopher Nolan
                        popularity: 49.577
                        profile_path: /xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg
                      - adult: false
                        gender: 1
                        id: 5009979
                        known_for_department: null
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 5.817
                        profile_path: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg
                      - adult: false
                        gender: 2
                        id: 4173
                        known_for_department: Acting
                        media_type: person
                        name: Anthony Hopkins
                        original_name: Anthony Hopkins
                        popularity: 44.113
                        profile_path: /iaf7SHSkGDpnyrDh1Jolilwk2TD.jpg
                      - adult: false
                        gender: 2
                        id: 1190668
                        known_for_department: Acting
                        media_type: person
                        name: Timothée Chalamet
                        original_name: Timothée Chalamet
                        popularity: 129.501
                        profile_path: /BE2sdjpgsa2rNTFa66f7upkaOP.jpg
                      - adult: false
                        gender: 2
                        id: 16483
                        known_for_department: Acting
                        media_type: person
                        name: Sylvester Stallone
                        original_name: Sylvester Stallone
                        popularity: 88.773
                        profile_path: /gn3pDWthJqR0VDYGViGD3048og7.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.362
                        profile_path: /7wMyr6F3yzvbSpu2XMxSW3vObED.jpg
                      - adult: false
                        gender: 1
                        id: 5009810
                        known_for_department: Acting
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 4.131
                        profile_path: /5mH6mkgwFZmeYTJpxVTaqbF3uIn.jpg
                      - adult: false
                        gender: 2
                        id: 190
                        known_for_department: Acting
                        media_type: person
                        name: Clint Eastwood
                        original_name: Clint Eastwood
                        popularity: 45.796
                        profile_path: /8TwdCfeOZH7ucRlfLZ6wObxa7cO.jpg
                      - adult: false
                        gender: 2
                        id: 500
                        known_for_department: Acting
                        media_type: person
                        name: Tom Cruise
                        original_name: Tom Cruise
                        popularity: 104.369
                        profile_path: /eOh4ubpOm2Igdg0QH2ghj0mFtC.jpg
                      - adult: false
                        gender: 0
                        id: 31912
                        known_for_department: Visual Effects
                        media_type: person
                        name: Andy Williams
                        original_name: Andy Williams
                        popularity: 0.001
                        profile_path: null
                      - adult: false
                        gender: 1
                        id: 2710789
                        known_for_department: Acting
                        media_type: person
                        name: Seung Ha
                        original_name: 채승하
                        popularity: 28.611
                        profile_path: /nvSJiHakYrDa3CedKSVOEsbLLX8.jpg
                      - adult: false
                        gender: 0
                        id: 5121818
                        known_for_department: Sound
                        media_type: person
                        name: Natalie Leggett
                        original_name: Natalie Leggett
                        popularity: 2.165
                        profile_path: null
                      - adult: false
                        gender: 2
                        id: 30614
                        known_for_department: Acting
                        media_type: person
                        name: Ryan Gosling
                        original_name: Ryan Gosling
                        popularity: 64.885
                        profile_path: /4X1wJo5xHm3YICPWZqVCPgLBEJ7.jpg
                      - adult: false
                        gender: 2
                        id: 3583157
                        known_for_department: Sound
                        media_type: person
                        name: Naoyuki Chikatani
                        original_name: 近谷直之
                        popularity: 0.001
                        profile_path: null
                      - adult: false
                        gender: 1
                        id: 1287869
                        known_for_department: Costume & Make-Up
                        media_type: person
                        name: Kelly Golden
                        original_name: Kelly Golden
                        popularity: 1.848
                        profile_path: null
                      - adult: false
                        gender: 2
                        id: 19292
                        known_for_department: Acting
                        media_type: person
                        name: Adam Sandler
                        original_name: Adam Sandler
                        popularity: 48.484
                        profile_path: /1xVMlB2Ufj8MtXzZkfQlPoadRMm.jpg
                      - adult: false
                        gender: 1
                        id: 3194176
                        known_for_department: Acting
                        media_type: person
                        name: Angeli Khang
                        original_name: Angeli Khang
                        popularity: 32.213
                        profile_path: /7vrTWF8PxQogF6o9ORZprYQoDOr.jpg
                      - adult: false
                        gender: 2
                        id: 10850
                        known_for_department: Production
                        media_type: person
                        name: Kevin Feige
                        original_name: Kevin Feige
                        popularity: 21.199
                        profile_path: /2XZT80gR72to084pEj4f0SCDmDn.jpg
                      - adult: false
                        gender: 2
                        id: 8891
                        known_for_department: Acting
                        media_type: person
                        name: John Travolta
                        original_name: John Travolta
                        popularity: 31.434
                        profile_path: /JSt3skdZpGPJYJixCZqH599WdI.jpg
                      - adult: false
                        gender: 1
                        id: 2472212
                        known_for_department: Acting
                        media_type: person
                        name: Sae Bom
                        original_name: Sae Bom
                        popularity: 8.595
                        profile_path: /mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg
                    total_pages: 234
                    total_results: 4672
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````