Save over 30% when you subscribe to an annual subscription plan!

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 curl -X GET "https://api.api-ninjas.com/v1/celebrity?name=Michael%20Jordan" \ -H "X-Api-Key: YOUR_API_KEY"

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.