> ## 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. # Person > Search for people by their name and also known as names. ## OpenAPI ````yaml api-reference/openapi.json get /3/search/person 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/search/person: get: tags: - Search summary: Person description: Search for people by their name and also known as names. operationId: person parameters: - name: query in: query schema: type: string example: '%22Miho%20Nomoto%22' - name: include_adult in: query schema: type: string example: 'false' - name: language in: query schema: type: string example: en-US - name: page in: query schema: type: string example: '1' responses: '200': description: Person headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=26877 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 10 Jan 2025 15:30:12 GMT ETag: schema: type: string example: W/"d4c409a62b691a7ecbafbc31ae1e1aa5" 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: kfkGno-xTgL0Y717vNUWFSfIo1VL1FXX4lnMKrc2BG7eDjvMbNFPQQ== 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: MISS, STORE x-memc-age: schema: type: string example: '0' x-memc-expires: schema: type: string example: '26877' x-memc-key: schema: type: string example: a453c01e1418bb8fe92d35199f5c0cbb 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: 550627 known_for: type: array items: type: object properties: adult: type: boolean example: false backdrop_path: type: string nullable: true example: /scMU7yDvzZdqpqb24WcuQB0i4fb.jpg genre_ids: type: array items: type: number example: 28 example: - 28 - 53 - 80 - 35 id: type: number example: 36282 media_type: type: string example: movie original_language: type: string example: ja original_title: type: string example: 極道戦国志 不動 overview: type: string example: >- In order to settle a business dispute, a mob leader murders one of his own teenage sons. The surviving son vows to avenge his brother's death, and organizes his own gang of teenage killers to destroy his father's organization. popularity: type: number example: 6.49 poster_path: type: string example: /kRlmTuDdZEGPbbXavNmiafUYYka.jpg release_date: type: string example: '1996-10-12' title: type: string example: 'Fudoh: The New Generation' video: type: boolean example: false vote_average: type: number example: 6.6 vote_count: type: number example: 64 example: - adult: false backdrop_path: /scMU7yDvzZdqpqb24WcuQB0i4fb.jpg genre_ids: - 28 - 53 - 80 - 35 id: 36282 media_type: movie original_language: ja original_title: 極道戦国志 不動 overview: >- In order to settle a business dispute, a mob leader murders one of his own teenage sons. The surviving son vows to avenge his brother's death, and organizes his own gang of teenage killers to destroy his father's organization. popularity: 6.49 poster_path: /kRlmTuDdZEGPbbXavNmiafUYYka.jpg release_date: '1996-10-12' title: 'Fudoh: The New Generation' video: false vote_average: 6.6 vote_count: 64 - adult: false backdrop_path: /1XUjqfCCgoqGiJYV6hfPlHOxC59.jpg genre_ids: - 28 - 18 - 53 id: 36274 media_type: movie original_language: ja original_title: 実録・安藤昇侠道（アウトロー）伝 烈火 overview: >- After Kunisada's Yakuza leader and father figure is brutally murdered, he and his best friend go on a two-man mission to avenge his death, killing other Yakuza leaders leading to a final confrontation by the old man's killers. popularity: 3.365 poster_path: /2r4WNCpwAQzekbaZwoCcOv1GJuO.jpg release_date: '2002-09-21' title: 'Deadly Outlaw: Rekka' video: false vote_average: 6.7 vote_count: 28 - adult: false backdrop_path: null genre_ids: - 18 id: 792589 media_type: movie original_language: cn original_title: 女歡 overview: Female modeling and lesbian interest popularity: 5.576 poster_path: /6owpqEOBcnDJ6r6GEoV4xZcdolo.jpg release_date: '1998-01-01' title: Intimate Desire video: false vote_average: 1.5 vote_count: 2 known_for_department: type: string example: Acting name: type: string example: Miho Nomoto original_name: type: string example: 野本美穂 popularity: type: number example: 133.991 profile_path: type: string nullable: true example: /ego6I5PWMZRJGYyu8aPjiNwsz3l.jpg example: - adult: false gender: 1 id: 550627 known_for: - adult: false backdrop_path: /scMU7yDvzZdqpqb24WcuQB0i4fb.jpg genre_ids: - 28 - 53 - 80 - 35 id: 36282 media_type: movie original_language: ja original_title: 極道戦国志 不動 overview: >- In order to settle a business dispute, a mob leader murders one of his own teenage sons. The surviving son vows to avenge his brother's death, and organizes his own gang of teenage killers to destroy his father's organization. popularity: 6.49 poster_path: /kRlmTuDdZEGPbbXavNmiafUYYka.jpg release_date: '1996-10-12' title: 'Fudoh: The New Generation' video: false vote_average: 6.6 vote_count: 64 - adult: false backdrop_path: /1XUjqfCCgoqGiJYV6hfPlHOxC59.jpg genre_ids: - 28 - 18 - 53 id: 36274 media_type: movie original_language: ja original_title: 実録・安藤昇侠道（アウトロー）伝 烈火 overview: >- After Kunisada's Yakuza leader and father figure is brutally murdered, he and his best friend go on a two-man mission to avenge his death, killing other Yakuza leaders leading to a final confrontation by the old man's killers. popularity: 3.365 poster_path: /2r4WNCpwAQzekbaZwoCcOv1GJuO.jpg release_date: '2002-09-21' title: 'Deadly Outlaw: Rekka' video: false vote_average: 6.7 vote_count: 28 - adult: false backdrop_path: null genre_ids: - 18 id: 792589 media_type: movie original_language: cn original_title: 女歡 overview: Female modeling and lesbian interest popularity: 5.576 poster_path: /6owpqEOBcnDJ6r6GEoV4xZcdolo.jpg release_date: '1998-01-01' title: Intimate Desire video: false vote_average: 1.5 vote_count: 2 known_for_department: Acting name: Miho Nomoto original_name: 野本美穂 popularity: 133.991 profile_path: /ego6I5PWMZRJGYyu8aPjiNwsz3l.jpg - adult: false gender: 0 id: 2533080 known_for: [] known_for_department: Acting name: Miho Nomoto original_name: Miho Nomoto popularity: 0.001 profile_path: null total_pages: type: number example: 1 total_results: type: number example: 2 examples: Person: value: page: 1 results: - adult: false gender: 1 id: 550627 known_for: - adult: false backdrop_path: /scMU7yDvzZdqpqb24WcuQB0i4fb.jpg genre_ids: - 28 - 53 - 80 - 35 id: 36282 media_type: movie original_language: ja original_title: 極道戦国志 不動 overview: >- In order to settle a business dispute, a mob leader murders one of his own teenage sons. The surviving son vows to avenge his brother's death, and organizes his own gang of teenage killers to destroy his father's organization. popularity: 6.49 poster_path: /kRlmTuDdZEGPbbXavNmiafUYYka.jpg release_date: '1996-10-12' title: 'Fudoh: The New Generation' video: false vote_average: 6.6 vote_count: 64 - adult: false backdrop_path: /1XUjqfCCgoqGiJYV6hfPlHOxC59.jpg genre_ids: - 28 - 18 - 53 id: 36274 media_type: movie original_language: ja original_title: 実録・安藤昇侠道（アウトロー）伝 烈火 overview: >- After Kunisada's Yakuza leader and father figure is brutally murdered, he and his best friend go on a two-man mission to avenge his death, killing other Yakuza leaders leading to a final confrontation by the old man's killers. popularity: 3.365 poster_path: /2r4WNCpwAQzekbaZwoCcOv1GJuO.jpg release_date: '2002-09-21' title: 'Deadly Outlaw: Rekka' video: false vote_average: 6.7 vote_count: 28 - adult: false backdrop_path: null genre_ids: - 18 id: 792589 media_type: movie original_language: cn original_title: 女歡 overview: Female modeling and lesbian interest popularity: 5.576 poster_path: /6owpqEOBcnDJ6r6GEoV4xZcdolo.jpg release_date: '1998-01-01' title: Intimate Desire video: false vote_average: 1.5 vote_count: 2 known_for_department: Acting name: Miho Nomoto original_name: 野本美穂 popularity: 133.991 profile_path: /ego6I5PWMZRJGYyu8aPjiNwsz3l.jpg - adult: false gender: 0 id: 2533080 known_for: [] known_for_department: Acting name: Miho Nomoto original_name: Miho Nomoto popularity: 0.001 profile_path: null total_pages: 1 total_results: 2 ````