Celebrity API

The Celebrity API provides the most popular information, such as net worth, profession, and birthday, on famous individuals all around the world. Our comprehensive database contains actors/actresses, athletes, politicians, business leaders, and much more.

/v1/celebrity GET

https://api.api-ninjas.com/v1/celebrity

Returns a list of up to 30 celebrities that match the search parameters. To get more than 30 results, use the offset parameter.


Parameters

  • name  optional

    Name of the celebrity you wish to search. This field is case-insensitive.

  • min_net_worth  optional

    Minimum net worth of celebrities.

  • max_net_worth  optional

    Maximum net worth of celebrities.

  • nationality  optional

    Nationality of celebrities. Must be an ISO 3166 Alpha-2 country code (e.g. US).

  • min_height  optional

    Minimum height of celebrities in meters (e.g. 1.65).

  • max_height  optional

    Maximum height of celebrities in meters (e.g. 1.80).

  • offset  premium  optional

    Number of results to offset for pagination.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

name
https://api.api-ninjas.com/v1/celebrity?name=Michael Jordan

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 [ { "name": "michael jordan", "net_worth": 2200000000, "gender": "male", "nationality": "us", "occupation": [ "basketball_player", "athlete", "spokesperson", "entrepreneur", "actor" ], "height": 1.98, "birthday": "1963-02-17" } ]

Code Examples

1 2 3 4 5 6 7 8 9 import requests name = 'Michael Jordan' api_url = 'https://api.api-ninjas.com/v1/celebrity?name={}'.format(name) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.