NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

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.

(4.8)

From 4,930 users

500+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
288ms303ms337ms649ms957ms

Didn't find what you were looking for? Suggest an improvement

/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.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • name

    Full name of the celebrity.

  • net_worth

    Net worth in US dollars.

  • gender

    Gender of the celebrity. Possible values: male, female.

  • nationality

    2-letter ISO 3166 Alpha-2 country code.

  • occupation

    Array of occupations.

  • height

    Height in meters.

  • birthday

    Birthday in YYYY-MM-DD format.

Sample Request Live Demo!

name

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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
[
    {
      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.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Celebrity API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The /v1/celebrity endpoint accepts several optional filter parameters, including min_net_worth and max_net_worth (in US dollars), min_height and max_height (in meters, e.g. 1.65), and nationality as an ISO 3166 Alpha-2 country code such as US. You can combine these without a name value to discover celebrities matching a profile; see the full parameter list in the API catalog.
  • Each request returns a JSON array of up to 30 celebrities matching your search parameters. To page beyond the first 30 results, use the offset parameter, which is a premium feature available on paid plans.
  • Each object includes the celebrity's name, net_worth (in US dollars), gender (male or female), nationality (a 2-letter country code), an occupation array, height in meters, and birthday in YYYY-MM-DD format. If a request fails you will instead receive an error response, documented on the error codes page.
  • The Celebrity API focuses on famous living and contemporary individuals such as actors, athletes, politicians, and business leaders. For notable people from history, use the dedicated Historical Figures API instead.