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

# People

> This endpoint gets the trending people on TMDB.



## OpenAPI

````yaml get /3/trending/person/{{time_window}}
openapi: 3.0.3
info:
  title: TMDb Endpoints
  description: >-
    Welcome to the TMDb API! You'll find a well-organized collection of
    endpoints, each helping you fetch different types of movie and TV data. The
    endpoints cover everything from searching for titles and getting details to
    managing lists and accessing ratings, all designed to give you precise
    control over the information you need.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
    description: Test server
  - url: https://api.themoviedb.org/3
    description: Production server
  - url: '{{base_url}}'
    description: Some other server
security: []
tags:
  - name: AUTHENTICATION
    description: The /account/{account_id} gets the public details of an account on TMDB.
  - name: ACCOUNT
    description: >-
      Account endpoints allow users to manage their personal information,
      ratings, watchlists, and other account-related data after authenticating.
  - name: CERTIFICATIONS
    description: >-
      The Certifications endpoints provide lists of movie and TV show content
      rating systems used in various countries.
  - name: CHANGES
    description: >-
      Changes endpoints allow you to track modifications made to movies, TV
      shows, and people in the TMDb database, providing a history of updates and
      enabling you to keep your local data synchronized.
  - name: COLLECTIONS
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
    description: >-
      Discover endpoints are powerful tools for finding movies and TV shows
      based on a wide range of criteria, such as genre, release date, rating,
      keywords, and more, enabling highly customized searches.
  - name: FIND
    description: This folder has find by ID endpoint
  - name: GENRES
    description: >-
      Genres endpoints provide lists of available movie and TV show genres,
      allowing you to categorize and filter content.
  - name: GUEST SESSIONS
    description: >-
      Guest session endpoints allow you to create temporary, unauthenticated
      sessions that grant limited access to certain API features, such as rating
      movies or TV shows without requiring a full user account.
  - name: KEYWORDS
    description: >-
      Keyword endpoints allow you to search for keywords and retrieve detailed
      information about specific keywords and the media associated with them.
  - name: LISTS
    description: >-
      Lists endpoints allow you to create, retrieve, modify, and delete custom
      lists of movies or TV shows.
  - name: MOVIE LIST
    description: >-
      The Movie List endpoints let you retrieve pre-made lists of movies,
      categorized by criteria like popularity, top rated, now playing, or
      upcoming releases.
  - name: MOVIES
    description: >-
      The Movie endpoints allow you to retrieve detailed information about
      movies, including titles, descriptions, cast, crew, ratings, and related
      data.
  - name: NETWORKS
    description: >-
      The NETWORKS endpoints let you retrieve information about television
      networks, such as their names, logos, and origin countries.
  - name: PEOPLE LISTS
    description: >-
      The People Lists endpoints let you retrieve lists of people based on
      criteria like popularity.
  - name: PEOPLE
    description: >-
      The PEOPLE endpoints let you get information about actors, directors, and
      other people involved in movies and TV shows.
  - name: REVIEWS
    description: >-
      The REVIEWS endpoints let you get user-written opinions and ratings about
      movies and TV shows.
  - name: SEARCH
    description: >-
      The "Search" endpoints let you find movies, TV shows, people, and other
      content by typing in keywords or names.
  - name: TRENDING
    description: >-
      The "Trending" endpoints show you what movies, TV shows, and people are
      currently popular or getting a lot of attention right now.
  - name: TV SERIES LISTS
    description: >-
      TV Series Lists endpoints provide access to pre-defined lists of TV shows,
      such as popular, top-rated, or airing today, allowing you to quickly
      retrieve collections of TV series based on specific criteria.
  - name: TV SERIES
    description: >-
      The TV series endpoints provide access to a wealth of information about
      television shows, including details, credits, seasons, episodes,
      recommendations, and more. See each of them below for specific
      information.
  - name: TV SEASONS
    description: >-
      The TV seasons endpoints allow you to retrieve details about specific
      seasons of a TV show, including information about the episodes within that
      season. See them below for specific information on how to use them.
  - name: TV EPISODES
    description: >-
      The TV episode endpoints allow you to retrieve detailed information about
      specific episodes of a TV show, including details like the episode number,
      name, air date, overview, and more. Check them out for specific
      information.
  - name: TV EPISODE GROUPS
    description: >-
      There's only one endpoint in this folder. Check the endpoint to find
      information about it.
  - name: WATCH PROVIDERS
    description: >-
      The Watch Providers endpoints provide information about streaming
      services, rental/purchase platforms, and sometimes even theatrical
      releases in different regions.
paths:
  /3/trending/person/{{time_window}}:
    parameters:
      - name: time_window
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - TRENDING
      summary: People
      description: This endpoint gets the trending people on TMDB.
      operationId: people
      responses:
        '200':
          description: People Example
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=40
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sun, 12 Jan 2025 15:58:14 GMT
            ETag:
              schema:
                type: string
                example: W/"c50090abd31b98d06fe4d40c525ea51c"
            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 afc076a932b635d1fe9febfccf7103f0.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: 2WZA30pdnBgukZs94OrgdGIWZmLJ7oo1sscwf5zNOHylpvW_FbvWxg==
            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: '560'
            x-memc-expires:
              schema:
                type: string
                example: '40'
            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: 18918
                        known_for_department:
                          type: string
                          nullable: true
                          example: Acting
                        media_type:
                          type: string
                          example: person
                        name:
                          type: string
                          example: Dwayne Johnson
                        original_name:
                          type: string
                          example: Dwayne Johnson
                        popularity:
                          type: number
                          example: 99.244
                        profile_path:
                          type: string
                          nullable: true
                          example: /kuqFzlYMc2IrsOyPznMd1FroeGq.jpg
                    example:
                      - adult: false
                        gender: 2
                        id: 18918
                        known_for_department: Acting
                        media_type: person
                        name: Dwayne Johnson
                        original_name: Dwayne Johnson
                        popularity: 99.244
                        profile_path: /kuqFzlYMc2IrsOyPznMd1FroeGq.jpg
                      - adult: false
                        gender: 2
                        id: 2461
                        known_for_department: Acting
                        media_type: person
                        name: Mel Gibson
                        original_name: Mel Gibson
                        popularity: 192.688
                        profile_path: /jnqHMaOslt8cef2atSmOpGRvNla.jpg
                      - adult: false
                        gender: 0
                        id: 1067215
                        known_for_department: Acting
                        media_type: person
                        name: Yardar Parnsombat
                        original_name: ญาดา ปานสมบัติ
                        popularity: 0.157
                        profile_path: null
                      - adult: false
                        gender: 1
                        id: 4153819
                        known_for_department: Acting
                        media_type: person
                        name: Jeong Yoon-I
                        original_name: Jeong Yoon-I
                        popularity: 25.038
                        profile_path: /zsIMMBDLYkAOM0LfziQR8hkc46M.jpg
                      - adult: false
                        gender: 1
                        id: 2472212
                        known_for_department: Acting
                        media_type: person
                        name: Sae Bom
                        original_name: Sae Bom
                        popularity: 12.051
                        profile_path: /mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg
                      - adult: false
                        gender: 1
                        id: 5009979
                        known_for_department: null
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 7.213
                        profile_path: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg
                      - adult: false
                        gender: 2
                        id: 11505
                        known_for_department: Writing
                        media_type: person
                        name: John Hughes
                        original_name: John Hughes
                        popularity: 25.555
                        profile_path: /nfGhXH2zcGPAOw8kNbnes516aZG.jpg
                      - adult: false
                        gender: 1
                        id: 2227
                        known_for_department: Acting
                        media_type: person
                        name: Nicole Kidman
                        original_name: Nicole Kidman
                        popularity: 107.888
                        profile_path: /lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg
                      - adult: false
                        gender: 1
                        id: 5009810
                        known_for_department: Acting
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 5.565
                        profile_path: /5mH6mkgwFZmeYTJpxVTaqbF3uIn.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: 84.447
                        profile_path: /7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg
                      - adult: false
                        gender: 2
                        id: 976
                        known_for_department: Acting
                        media_type: person
                        name: Jason Statham
                        original_name: Jason Statham
                        popularity: 156.507
                        profile_path: /whNwkEQYWLFJA8ij0WyOOAD5xhQ.jpg
                      - adult: false
                        gender: 1
                        id: 1997928
                        known_for_department: Acting
                        media_type: person
                        name: Jin Joo
                        original_name: 진주
                        popularity: 82.062
                        profile_path: /awN0RgLUn0j8AsGsC4JNT1gdkVI.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.379
                        profile_path: /7wMyr6F3yzvbSpu2XMxSW3vObED.jpg
                      - adult: false
                        gender: 1
                        id: 3165040
                        known_for_department: Acting
                        media_type: person
                        name: Rika
                        original_name: Rika
                        popularity: 77.329
                        profile_path: /vwYqrhcSRVrnra4S0NopnywN8rK.jpg
                      - adult: false
                        gender: 2
                        id: 6193
                        known_for_department: Acting
                        media_type: person
                        name: Leonardo DiCaprio
                        original_name: Leonardo DiCaprio
                        popularity: 119.894
                        profile_path: /ts9l18VkDSooRGDWIeQegNVHciC.jpg
                      - adult: false
                        gender: 2
                        id: 1269
                        known_for_department: Acting
                        media_type: person
                        name: Kevin Costner
                        original_name: Kevin Costner
                        popularity: 72.762
                        profile_path: /608blZipRDZkDpzp8VItB64qMaT.jpg
                      - adult: false
                        gender: 2
                        id: 2963
                        known_for_department: Acting
                        media_type: person
                        name: Nicolas Cage
                        original_name: Nicolas Cage
                        popularity: 95.498
                        profile_path: /ar33qcWbEgREn07ZpXv5Pbj8hbM.jpg
                      - adult: false
                        gender: 2
                        id: 1435525
                        known_for_department: Directing
                        media_type: person
                        name: Jerry White Jr.
                        original_name: Jerry White Jr.
                        popularity: 0.001
                        profile_path: /ly85IL1VACCPSxaKtyBbFTBuWYB.jpg
                      - adult: false
                        gender: 1
                        id: 204
                        known_for_department: Acting
                        media_type: person
                        name: Kate Winslet
                        original_name: Kate Winslet
                        popularity: 51.616
                        profile_path: /e3tdop3WhseRnn8KwMVLAV25Ybv.jpg
                      - adult: false
                        gender: 1
                        id: 25837
                        known_for_department: Acting
                        media_type: person
                        name: Elisha Cuthbert
                        original_name: Elisha Cuthbert
                        popularity: 67.77
                        profile_path: /lsNwsJjGZqgjVUI1mhtcDCuwES3.jpg
                  total_pages:
                    type: number
                    example: 229
                  total_results:
                    type: number
                    example: 4577
              examples:
                People Example:
                  value:
                    page: 1
                    results:
                      - adult: false
                        gender: 2
                        id: 18918
                        known_for_department: Acting
                        media_type: person
                        name: Dwayne Johnson
                        original_name: Dwayne Johnson
                        popularity: 99.244
                        profile_path: /kuqFzlYMc2IrsOyPznMd1FroeGq.jpg
                      - adult: false
                        gender: 2
                        id: 2461
                        known_for_department: Acting
                        media_type: person
                        name: Mel Gibson
                        original_name: Mel Gibson
                        popularity: 192.688
                        profile_path: /jnqHMaOslt8cef2atSmOpGRvNla.jpg
                      - adult: false
                        gender: 0
                        id: 1067215
                        known_for_department: Acting
                        media_type: person
                        name: Yardar Parnsombat
                        original_name: ญาดา ปานสมบัติ
                        popularity: 0.157
                        profile_path: null
                      - adult: false
                        gender: 1
                        id: 4153819
                        known_for_department: Acting
                        media_type: person
                        name: Jeong Yoon-I
                        original_name: Jeong Yoon-I
                        popularity: 25.038
                        profile_path: /zsIMMBDLYkAOM0LfziQR8hkc46M.jpg
                      - adult: false
                        gender: 1
                        id: 2472212
                        known_for_department: Acting
                        media_type: person
                        name: Sae Bom
                        original_name: Sae Bom
                        popularity: 12.051
                        profile_path: /mM43mwxU8YAbRFJPFEwoFYV0CQO.jpg
                      - adult: false
                        gender: 1
                        id: 5009979
                        known_for_department: null
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 7.213
                        profile_path: /pDVfME2z2DiosnHFBALHvoSvqs5.jpg
                      - adult: false
                        gender: 2
                        id: 11505
                        known_for_department: Writing
                        media_type: person
                        name: John Hughes
                        original_name: John Hughes
                        popularity: 25.555
                        profile_path: /nfGhXH2zcGPAOw8kNbnes516aZG.jpg
                      - adult: false
                        gender: 1
                        id: 2227
                        known_for_department: Acting
                        media_type: person
                        name: Nicole Kidman
                        original_name: Nicole Kidman
                        popularity: 107.888
                        profile_path: /lfW2cDigTcvuoe4k6UfCdGVE1R6.jpg
                      - adult: false
                        gender: 1
                        id: 5009810
                        known_for_department: Acting
                        media_type: person
                        name: 河北彩花
                        original_name: 河北彩花
                        popularity: 5.565
                        profile_path: /5mH6mkgwFZmeYTJpxVTaqbF3uIn.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: 84.447
                        profile_path: /7DP3bm3MS0qa0L8tBLHGebbCu6H.jpg
                      - adult: false
                        gender: 2
                        id: 976
                        known_for_department: Acting
                        media_type: person
                        name: Jason Statham
                        original_name: Jason Statham
                        popularity: 156.507
                        profile_path: /whNwkEQYWLFJA8ij0WyOOAD5xhQ.jpg
                      - adult: false
                        gender: 1
                        id: 1997928
                        known_for_department: Acting
                        media_type: person
                        name: Jin Joo
                        original_name: 진주
                        popularity: 82.062
                        profile_path: /awN0RgLUn0j8AsGsC4JNT1gdkVI.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.379
                        profile_path: /7wMyr6F3yzvbSpu2XMxSW3vObED.jpg
                      - adult: false
                        gender: 1
                        id: 3165040
                        known_for_department: Acting
                        media_type: person
                        name: Rika
                        original_name: Rika
                        popularity: 77.329
                        profile_path: /vwYqrhcSRVrnra4S0NopnywN8rK.jpg
                      - adult: false
                        gender: 2
                        id: 6193
                        known_for_department: Acting
                        media_type: person
                        name: Leonardo DiCaprio
                        original_name: Leonardo DiCaprio
                        popularity: 119.894
                        profile_path: /ts9l18VkDSooRGDWIeQegNVHciC.jpg
                      - adult: false
                        gender: 2
                        id: 1269
                        known_for_department: Acting
                        media_type: person
                        name: Kevin Costner
                        original_name: Kevin Costner
                        popularity: 72.762
                        profile_path: /608blZipRDZkDpzp8VItB64qMaT.jpg
                      - adult: false
                        gender: 2
                        id: 2963
                        known_for_department: Acting
                        media_type: person
                        name: Nicolas Cage
                        original_name: Nicolas Cage
                        popularity: 95.498
                        profile_path: /ar33qcWbEgREn07ZpXv5Pbj8hbM.jpg
                      - adult: false
                        gender: 2
                        id: 1435525
                        known_for_department: Directing
                        media_type: person
                        name: Jerry White Jr.
                        original_name: Jerry White Jr.
                        popularity: 0.001
                        profile_path: /ly85IL1VACCPSxaKtyBbFTBuWYB.jpg
                      - adult: false
                        gender: 1
                        id: 204
                        known_for_department: Acting
                        media_type: person
                        name: Kate Winslet
                        original_name: Kate Winslet
                        popularity: 51.616
                        profile_path: /e3tdop3WhseRnn8KwMVLAV25Ybv.jpg
                      - adult: false
                        gender: 1
                        id: 25837
                        known_for_department: Acting
                        media_type: person
                        name: Elisha Cuthbert
                        original_name: Elisha Cuthbert
                        popularity: 67.77
                        profile_path: /lsNwsJjGZqgjVUI1mhtcDCuwES3.jpg
                    total_pages: 229
                    total_results: 4577
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````