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

# Person

> This endpoint search for people by their name and also known as names.




## OpenAPI

````yaml get /search/person
openapi: 3.0.3
info:
  title: TMDB API DOCUMENTATION
  description: >-
    The Movie Database is an API that provides comprehensive movie, TV show, and
    celebrity data. TMDB offers APIs that developers use to access and integrate
    its data into applications, websites, or services.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Endpoints for managing authentication, including login and user sessions.
  - name: Account
    description: Endpoints for managing user accounts, such as profiles and settings.
  - name: Certification
    description: Endpoints for retrieving and managing certification data.
  - name: Changes
    description: Endpoints for tracking changes and updates across the system.
  - name: Collection
    description: Endpoints for managing and accessing user collections.
  - name: Companies
    description: Endpoints for retrieving and managing company-related data.
  - name: Configuration
    description: Endpoints for accessing and updating system configuration settings.
  - name: Credits
    description: Endpoints for retrieving credit information related to movies or shows.
  - name: Discover
    description: Endpoints for discovering content based on filters and criteria.
  - name: Find
    description: Endpoints for locating specific items or entities in the database.
  - name: Genres
    description: Endpoints for retrieving and managing genres for categorization.
  - name: Guest Sessions
    description: Endpoints for creating and managing guest user sessions.
  - name: Keywords
    description: Endpoints for managing and searching content using keywords.
  - name: Lists
    description: Endpoints for creating and managing user-generated lists.
  - name: Movie Lists
    description: Endpoints for retrieving and managing lists of movies.
  - name: Movies
    description: Endpoints for retrieving detailed information about movies.
  - name: Networks
    description: Endpoints for retrieving and managing network-related data.
  - name: People Lists
    description: Endpoints for retrieving and managing lists of people in the system.
  - name: People
    description: Endpoints for retrieving information about actors, directors, and others.
  - name: Search
    description: Endpoints for performing searches across multiple categories.
  - name: Reviews
    description: Endpoints for managing and displaying reviews from users.
  - name: Trending
    description: Endpoints for retrieving trending content based on popularity.
  - name: TV Series Lists
    description: Endpoints for retrieving and managing lists of TV series.
  - name: TV Series
    description: Endpoints for retrieving detailed information about TV series.
  - name: TV Seasons
    description: Endpoints for retrieving and managing information about TV seasons.
  - name: TV Episodes
    description: Endpoints for retrieving and managing information about TV episodes.
  - name: TV Episode Groups
    description: Endpoints for managing groups of TV episodes organized by criteria.
  - name: Watch Providers
    description: >-
      Endpoints for retrieving availability information from streaming
      providers.
  - name: Auth
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
  - name: Lists
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
paths:
  /search/person:
    get:
      tags:
        - Search
      summary: Person
      description: |
        This endpoint search for people by their name and also known as names.
      operationId: searchPerson
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
          description: Filter or retrieve specific results
        - name: include_adult
          in: query
          required: false
          schema:
            type: boolean
          description: Defaults to false
        - name: language
          in: query
          required: false
          description: Defaults to en-US
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: Defaults to 1
          schema:
            type: integer
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                    description: Indicates the current page number
                  results:
                    type: array
                    description: Contains the list of data or items
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                          description: Indicates whether the person is an adult
                        gender:
                          type: integer
                          description: >-
                            The gender of the person, represented as an integer
                            (e.g., 1 for female, 2 for male)
                        id:
                          type: integer
                          description: A unique identifier assigned to the person
                        known_for_department:
                          type: string
                          description: The primary department the person is known for
                        name:
                          type: string
                          description: The full name of the person
                        original_name:
                          type: string
                          description: >-
                            The city, state, or country where the person was
                            born
                        popularity:
                          type: number
                        profile_path:
                          type: string
                        known_for:
                          type: array
                          description: A list of media items the person is known for
                          items:
                            type: object
                            properties:
                              adult:
                                type: boolean
                                description: Indicates whether the media item is for adults
                              backdrop_path:
                                type: string
                                description: >-
                                  The relative path to the backdrop image of the
                                  media item
                              id:
                                type: integer
                                description: A unique identifier for the media item
                              title:
                                type: string
                                description: The title of the media item
                              original_language:
                                type: string
                                description: The original language code of the media item
                              original_title:
                                type: string
                                description: The original title of the media item
                              overview:
                                type: string
                                description: >-
                                  A brief description or overview of the media
                                  item
                              poster_path:
                                type: string
                                description: >-
                                  The relative path or URL to the poster image
                                  of the media item
                              media_type:
                                type: string
                                description: The type of media (e.g., movie, tv)
                              genre_ids:
                                type: array
                                description: >-
                                  A list of genre identifiers associated with
                                  the media item
                                items:
                                  type: integer
                              popularity:
                                type: number
                                description: >-
                                  A numeric value indicating the media item's
                                  popularity
                              release_date:
                                type: string
                                description: >-
                                  The release date of the media item in
                                  YYYY-MM-DD format
                              video:
                                type: boolean
                                description: >-
                                  Indicates whether the media item contains
                                  video content
                              vote_average:
                                type: number
                                description: The average user vote for the media item
                              vote_count:
                                type: integer
                                description: >-
                                  The total number of votes the media item has
                                  received
                  total_pages:
                    type: integer
                    description: Specifies the total number of pages available
                  total_results:
                    type: integer
                    description: >-
                      Represents the total number of items or records in a
                      dataset
                example:
                  page: 1
                  results:
                    - adult: false
                      gender: 2
                      id: 31
                      known_for_department: Acting
                      name: Tom Hanks
                      original_name: Tom Hanks
                      popularity: 84.631
                      profile_path: /xndWFsBlClOJFRdhSt4NBwiPq2o.jpg
                      known_for:
                        - adult: false
                          backdrop_path: /3h1JZGDhZ8nzxdgvkxha0qBqi05.jpg
                          id: 13
                          title: Forrest Gump
                          original_language: en
                          original_title: Forrest Gump
                          overview: >-
                            A man with a low IQ has accomplished great things in
                            his life and been present during significant
                            historic events—in each case, far exceeding what
                            anyone imagined he could do. But despite all he has
                            achieved, his one true love eludes him.
                          poster_path: /arw2vcBveWOVZr6pxd9XTd1TdQa.jpg
                          media_type: movie
                          genre_ids:
                            - 35
                            - 18
                            - 10749
                          popularity: 67.209
                          release_date: '1994-06-23'
                          video: false
                          vote_average: 8.481
                          vote_count: 24525
                        - adult: false
                          backdrop_path: /3Rfvhy1Nl6sSGJwyjb0QiZzZYlB.jpg
                          id: 862
                          title: Toy Story
                          original_language: en
                          original_title: Toy Story
                          overview: >-
                            Led by Woody, Andy's toys live happily in his room
                            until Andy's birthday brings Buzz Lightyear onto the
                            scene. Afraid of losing his place in Andy's heart,
                            Woody plots against Buzz. But when circumstances
                            separate Buzz and Woody from their owner, the duo
                            eventually learns to put aside their differences.
                          poster_path: /uXDfjJbdP4ijW5hWSBrPrlKpxab.jpg
                          media_type: movie
                          genre_ids:
                            - 16
                            - 12
                            - 10751
                            - 35
                          popularity: 119.802
                          release_date: '1995-10-30'
                          video: false
                          vote_average: 7.969
                          vote_count: 16613
                        - adult: false
                          backdrop_path: /vxJ08SvwomfKbpboCWynC3uqUg4.jpg
                          id: 497
                          title: The Green Mile
                          original_language: en
                          original_title: The Green Mile
                          overview: >-
                            A supernatural tale set on death row in a Southern
                            prison, where gentle giant John Coffey possesses the
                            mysterious power to heal people's ailments. When the
                            cell block's head guard, Paul Edgecomb, recognizes
                            Coffey's miraculous gift, he tries desperately to
                            help stave off the condemned man's execution.
                          poster_path: /o0lO84GI7qrG6XFvtsPOSV7CTNa.jpg
                          media_type: movie
                          genre_ids:
                            - 14
                            - 18
                            - 80
                          popularity: 77.553
                          release_date: '1999-12-10'
                          video: false
                          vote_average: 8.507
                          vote_count: 15310
                  total_pages: 1
                  total_results: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.