Get started

Asteroids and comets (JPL) in Duaer

In Duaer: One asteroid or comet from the NASA JPL Small-Body Database: orbit, size, rotation, albedo, and near-Earth and hazard flags. One successful search uses 1 credit.

What you get

Duaer Asteroids and comets (JPL) looks up one small body by name, number, or designation. When a name matches several objects, it lists them so you can pick one.

Pick Duaer Data → Asteroids and comets (JPL) in the node creator, or open the data market. Related: Asteroid close approaches, Exoplanets.

When to use it

Get the size and orbit of an asteroid such as Apophis.
Check whether an object is near-Earth or potentially hazardous.

When not to use it

Upcoming close approaches. Use Asteroid close approaches.
Planets around other stars. Use Exoplanets.

Search on the canvas

Open the node creator and pick Duaer Data → Asteroids and comets (JPL).
Fill Asteroid or Comet (such as Apophis).
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/small-bodies?object=Apophis
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-small-bodies
description: >-
  Duaer Asteroids and comets (JPL). One asteroid or comet from the NASA JPL Small-Body Database: orbit, size, rotation, albedo, and near-Earth and hazard flags.
  One successful search uses 1 Duaer credit.
---

# Duaer Asteroids and comets (JPL)

Duaer Asteroids and comets (JPL) looks up one small body by name, number, or designation. When a name matches several objects, it lists them so you can pick one.

## When to use

- Get the size and orbit of an asteroid such as Apophis.
- Check whether an object is near-Earth or potentially hazardous.

## When not to use

- Upcoming close approaches. Use https://skills.duaer.com/close-approaches.md.
- Planets around other stars. Use https://skills.duaer.com/exoplanets.md.

## Call

`GET https://api.duaer.com/v1/data/small-bodies?object=Apophis`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `object`.

- `object` — Name, number, or designation, such as Eros, 433, Apophis, or 1P.

## Examples

- `GET https://api.duaer.com/v1/data/small-bodies?object=Apophis` — asteroid Apophis.
- `GET https://api.duaer.com/v1/data/small-bodies?object=1P` — comet Halley.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `designation`, `fullName`, `kind`, `orbitClass` — identity and orbit class.
- `nearEarthObject`, `potentiallyHazardous`, `earthMoidAu` — Earth risk flags and minimum orbit distance.
- `diameterKm`, `albedo`, `rotationHours`, `absoluteMagnitude`, `spectralType` — physical data, when measured.
- `semiMajorAxisAu`, `eccentricity`, `inclinationDeg`, `perihelionAu`, `aphelionAu`, `orbitalPeriodDays` — orbit.

Several matches return one row each with `designation` only; call again with that designation.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/close-approaches.md — Duaer Asteroid close approaches
- https://skills.duaer.com/exoplanets.md — Duaer Exoplanets

Questions

How many credits does a Asteroids and comets (JPL) search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

What if a name matches several objects in Duaer Asteroids and comets (JPL)?

Duaer returns one row per candidate with designation only. Search again with that designation.

In this section

Get started

Asteroid close approaches in Duaer

In Duaer: Upcoming asteroid and comet close approaches to Earth from NASA JPL, with date, distance in lunar distances, speed, and size. One successful search uses 1 credit.

Get started

Exoplanets in Duaer

In Duaer: Confirmed exoplanets from the NASA Exoplanet Archive by planet or star name, discovery method, or year, with size, mass, orbit, and distance. One successful search uses 1 credit.