Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Stars API

The Stars API provides key statistics for thousands of stars discovered in the known universe.

(4.1)

From 9,702 users

2,600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
343ms390ms436ms837ms1062ms

Similar APIs

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

/v1/stars GET

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

Get a list of stars 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) is required.

  • name  optional

    The name of the star. Note that many of the star names contain Greek characters.

  • constellation  optional

    The constellation that the star belongs to.

  • min_apparent_magnitude  optional

    Minimum apparent magnitude brightness of the star.

  • max_apparent_magnitude  optional

    Maximum apparent magnitude brightness of the star.

  • min_absolute_magnitude  optional

    Minimum absolute magnitude brightness of the star.

  • max_absolute_magnitude  optional

    Maximum absolute magnitude brightness of the star.

  • min_distance_light_year  optional

    Minimum distance the star is from Earth in light years.

  • max_distance_light_year  optional

    Maximum distance the star is from Earth in light years.

  • offset  optional

    Number of results to offset for pagination.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of star objects, each containing:

  • name

    The name of the star.

  • constellation

    The constellation that the star belongs to.

  • right_ascension

    The right ascension coordinate of the star.

  • declination

    The declination coordinate of the star.

  • apparent_magnitude

    The apparent magnitude (brightness as seen from Earth) of the star.

  • absolute_magnitude

    The absolute magnitude (intrinsic brightness) of the star.

  • distance_light_year

    The distance from Earth in light years.

  • spectral_class

    The spectral classification of the star.

Sample Request Live Demo!

name
constellation
min_apparent_magnitude
max_apparent_magnitude
min_absolute_magnitude

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/stars?name=vega

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 [ { "name": "Vega", "constellation": "Lyra", "right_ascension": "18h 36m 56.19s", "declination": "+38° 46′ 58.8″", "apparent_magnitude": "0.03", "absolute_magnitude": "0.58", "distance_light_year": "25", "spectral_class": "A0Vvar" } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/stars?name=vega" \ -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.