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

Planets API

The Planets API provides key statistics for thousands of planets and exoplanets discovered in the known universe.

(4.7)

From 6,924 users

4,300+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
281ms305ms338ms534ms969ms

Similar APIs

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

/v1/planets GET

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

Get a list of planets matching specified parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in multiple API calls.

Parameters

At least one of the following parameters (other than offset) must be set:

  • name  optional

    The name of the planet.

  • min_mass  optional

    Minimum mass of the planet in Jupiters (1 Jupiter = 1.898 × 1027 kg).

  • max_mass  optional

    Maximum mass of the planet in Jupiters (1 Jupiter = 1.898 × 1027 kg).

  • min_radius  optional

    Minimum average radius of the planet in Jupiters (1 Jupiter = 69911 km).

  • max_radius  optional

    Maximum average radius of the planet in Jupiters (1 Jupiter = 69911 km).

  • min_period  optional

    Minimum orbital period of the planet in Earth days.

  • max_period  optional

    Maximum orbital period of the planet in Earth days.

  • min_temperature  optional

    Minimum average surface temperature of the planet in Kelvin.

  • max_temperature  optional

    Maximum average surface temperature of the planet in Kelvin.

  • min_distance_light_year  optional

    Minimum distance the planet is from Earth in light years.

  • max_distance_light_year  optional

    Maximum distance the planet is from Earth in light years.

  • min_semi_major_axis  optional

    Minimum semi major axis of planet in astronomical units (AU).

  • max_semi_major_axis  optional

    Maximum semi major axis of planet in astronomical units (AU).

  • offset  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

    The name of the planet.

  • mass

    Mass of the planet in Jupiters (1 Jupiter = 1.898 × 1027 kg).

  • radius

    Average radius of the planet in Jupiters (1 Jupiter = 69911 km).

  • period

    Orbital period of the planet in Earth days.

  • semi_major_axis

    Semi-major axis of the planet's orbit in astronomical units (AU).

  • temperature

    Average surface temperature of the planet in Kelvin.

  • distance_light_year

    Distance from Earth in light years.

  • host_star_mass

    Mass of the host star in solar masses.

  • host_star_temperature

    Temperature of the host star in Kelvin.

Sample Request Live Demo!

name
min_mass
max_mass
min_radius
max_radius

Try this endpoint live with a free API key

Instant access — no credit card required.

https://api.api-ninjas.com/v1/planets?name=Neptune

Headers

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

Sample Response

JSON
[
    {
      name:"Neptune",
      mass:0.0537,
      radius:0.346,
      period:59800,
      semi_major_axis:30.07,
      temperature:72,
      distance_light_year:0.000478,
      host_star_mass:1,
      host_star_temperature:6000
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/planets?name=Neptune" \ -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 Planets 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 Planets API returns key statistics for thousands of planets and exoplanets discovered in the known universe, including each planet's mass and radius (in Jupiters), orbital period in Earth days, semi_major_axis in AU, average surface temperature in Kelvin, and distance_light_year from Earth. It also reports details about the planet's star via the host_star_mass (in solar masses) and host_star_temperature (in Kelvin) fields.
  • Pass the name parameter to look up a planet directly (for example name=Neptune), or filter by physical characteristics using range parameters such as min_mass/max_mass, min_radius/max_radius, min_period/max_period, min_temperature/max_temperature, and min_distance_light_year/max_distance_light_year. At least one of these parameters (other than offset) must be set; see the API documentation for the full list.
  • Each request returns at most 30 results, so to page through larger result sets you set the offset parameter across multiple calls (for example offset=30 for the next page). Higher request volumes are supported on paid plans listed on the pricing page.
  • The Planets API is useful for astronomy education apps, exoplanet data dashboards, and trivia or quiz games that filter planets by mass, radius, or distance_light_year. It pairs well with the Stars API for host-star data and the Facts API for surfacing fun astronomy facts.