Search People

This is a good starting point to start finding people on TMDb. The idea is to be a quick and light method so you can iterate through people quickly. This method is purposefully lighter than the 2.1 search. It searches. That’s all.

In order to use the file paths returned in this method and find the available sizes you need to understand how the configuration system works. Please consult the configuration article for more information.

HTTP Request

GET http://api.themoviedb.org/3/search/person

Required Parameters

• api_key

• query

  The query param is your search text. It works best when the text has been properly escaped.

Optional Parameters

• page

  Some searches will have more than 20 results, the default number of items returned per page. To iterate through use the page parameter.

• include_adult

  You can toggle whether or not to include adult items in your search by using this parameter. The expected value is either true or false. When it is not specified, it is set to false.

HTTP Response

{
    "page": 1, 
    "results": [
        {
            "adult": false, 
            "id": 287, 
            "name": "Brad Pitt", 
            "profile_path": "/w8zJQuN7tzlm6FY9mfGKihxp3Cb.jpg"
        }
    ], 
    "total_pages": 1, 
    "total_results": 1
}