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

# People

> This endpoint get the trending people on TMDB.



## OpenAPI

````yaml api-reference/openapi3.json get /3/trending/person/{time_window}
openapi: 3.0.3
info:
  title: The Movie Database
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: AUTHENTICATION
  - name: ACCOUNT
  - name: CERTIFICATIONS
  - name: CHANGES
  - name: COLLECTIONS
  - name: COMPANY
  - name: CONFIGURATION
  - name: CREDIT
  - name: DISCOVER
  - name: FIND
  - name: GENRES
  - name: GUEST SESSIONS
  - name: KEYWORDS
  - name: LISTS
  - name: MOVIE LISTS
  - name: MOVIES
  - name: NETWORKS
  - name: PEOPLE LIST
  - name: PEOPLE
  - name: REVIEWS
  - name: SEARCH
  - name: TRENDING
  - name: TV SERIES LIST
  - name: TV SERIES
  - name: TV SEASONS
  - name: TV EPISODES
  - name: TV EPISODE GROUP
  - name: WATCH PROVIDERS
paths:
  /3/trending/person/{time_window}:
    get:
      tags:
        - TRENDING
      summary: People
      description: This endpoint get the trending people on TMDB.
      operationId: people
      parameters:
        - $ref: '#/components/parameters/language'
        - $ref: '#/components/parameters/time_window'
      responses:
        '200':
          description: people
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=76
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sun, 05 Jan 2025 17:50:08 GMT
            ETag:
              schema:
                type: string
                example: W/"0fac4c6d7442df33961b7b620a0c5d89"
            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 db72f6ab1d9d27534c6158ca17e3af1c.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: BI3nmJMec2oGLV4eZaNMJcMMnE3ggdU8I2rqibjvmspKfNP1JDSlww==
            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: '524'
            x-memc-expires:
              schema:
                type: string
                example: '76'
            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: 17276
                        known_for_department:
                          type: string
                          nullable: true
                          example: Acting
                        media_type:
                          type: string
                          example: person
                        name:
                          type: string
                          example: Gerard Butler
                        original_name:
                          type: string
                          example: Gerard Butler
                        popularity:
                          type: number
                          example: 55.612
                        profile_path:
                          type: string
                          nullable: true
                          example: /rTO5opVC3Gs6hPYAxWSP9eEjogi.jpg
                    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:
                    type: number
                    example: 266
                  total_results:
                    type: number
                    example: 5304
              examples:
                people:
                  value:
                    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
components:
  parameters:
    language:
      name: language
      in: query
      description: Specifies the language in which the response should be returned.
      schema:
        type: string
        example: en-US
    time_window:
      name: time_window
      in: path
      required: true
      description: >-
        It allows users to specify whether they want to receive trending data
        for a single day ("day") or for the entire week ("week").
      schema:
        type: string
        enum:
          - day
          - week
        example: day
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````