# NASA Exoplanet Archive · Search planets

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

- Provider: Alexandria
- Category: Public Records
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `exoplanetarchive-ipac-caltech-edu/exoplanets/search_planets`
- Page: https://spiral.ai/tools/alexandria/exoplanetarchive-ipac-caltech-edu/exoplanets/search_planets

## Pricing

$0.00873 per call.

## Limits

- 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 | Allowed | 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). |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=exoplanetarchive-ipac-caltech-edu%2Fexoplanets%2Fsearch_planets

## Common questions

### NASA Exoplanet Archive · Search planets

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

