Person

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

GET /search/person

Person

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/search/person \
  --header 'Authorization: Bearer <token>'

200

{
  "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
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

query · string · required

Filter or retrieve specific results

include_adult · boolean

Defaults to false

language · string

Defaults to en-US

page · integer

Defaults to 1

Response

200 - application/json

Successful

page · integer

Indicates the current page number

results · object[]

Contains the list of data or items

Show child attributes

total_pages · integer

Specifies the total number of pages available

total_results · integer

Represents the total number of items or records in a dataset