NASA Exoplanet Archive · Search planets
exoplanetarchive-ipac-caltech-edu/exoplanets/search_planetsSearch public records with NASA Exoplanet Archive · Search planets from Alexandria through one Spiral API key. Questions over the catalogue: recent discoveries, planets found by TESS or JWST, Earth-sized planets in temperate orbits, the nearest exoplanets, how many planets microlensing has found. Ranges are inclusive, and a planet without a value for a filtered field is left out. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
sort | one of newest, oldest, nearest, smallest_radius, largest_radius, shortest_period, longest_period, name | newest | Order: newest or oldest discovery publication, nearest system, radius or orbital period ascending/descending, or name. Numeric sorts leave out planets without that value. |
limit | number 1 to 100 | 25 | Planets to return (1 to 100). |
host_name | text | — | Only planets of this host star (case and spaces ignored). |
mass_earth_max | number 0 to … | — | Highest mass in Earth masses (planets with no mass value are excluded when set) (inclusive). |
mass_earth_min | number 0 to … | — | Lowest mass in Earth masses (planets with no mass value are excluded when set) (inclusive). |
distance_pc_max | number 0 to … | — | Highest system distance in parsecs (1 pc = 3.26 light years) (inclusive). |
distance_pc_min | number 0 to … | — | Lowest system distance in parsecs (1 pc = 3.26 light years) (inclusive). |
discovery_method | one of Astrometry, Disk Kinematics, Eclipse Timing Variations, Imaging, Microlensing, Orbital Brightness Modulation, Pulsar Timing, Pulsation Timing Variations, Radial Velocity, Transit, Transit Timing Variations | — | Only planets found by this method. |
radius_earth_max | number 0 to … | — | Highest radius in Earth radii (inclusive). |
radius_earth_min | number 0 to … | — | Lowest radius in Earth radii (inclusive). |
discovery_facility | text | — | Case-insensitive substring of the discovery facility, e.g. 'TESS', 'Kepler', 'James Webb', 'Keck'. |
discovery_year_max | number 1980 to 2100 | — | Highest discovery year (inclusive). |
discovery_year_min | number 1980 to 2100 | — | Lowest discovery year (inclusive). |
orbital_period_days_max | number 0 to … | — | Highest orbital period in days (inclusive). |
orbital_period_days_min | number 0 to … | — | Lowest orbital period in days (inclusive). |
equilibrium_temperature_k_max | number 0 to … | — | Highest equilibrium temperature in kelvin (inclusive). |
equilibrium_temperature_k_min | number 0 to … | — | Lowest equilibrium temperature in kelvin (inclusive). |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "exoplanetarchive-ipac-caltech-edu/exoplanets/search_planets",
"input": {
"sort": "newest"
}
}'Frequently asked questions
How much does NASA Exoplanet Archive · Search planets cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use NASA Exoplanet Archive · Search planets through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "exoplanetarchive-ipac-caltech-edu/exoplanets/search_planets"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use NASA Exoplanet Archive · Search planets?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use NASA Exoplanet Archive · Search planets?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.