What it returns
Near-Earth asteroid and comet data from NASA JPL's Solar System Dynamics APIs (CNEOS).
Common uses
Space news and alerts, education and planetarium apps, research dashboards. Pay per row returned.
Request
POST https://api.pushbuild.com/asteroid-close-approaches/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: approaches, impactRisk, lookup | Close approaches, impact-risk list, or object lookup. Default: "approaches". |
dateFrom | string | Approaches: YYYY-MM-DD or now (default now). |
dateTo | string | Approaches: YYYY-MM-DD or +days, e.g. +60 (default). |
maxDistanceAu | number | Approaches: default 0.05 au (about 19.5 lunar distances). |
maxH | number | Approaches: smaller H = larger object, e.g. 22 for about 140 m and up. |
pha | boolean | Approaches only. |
object | string | Lookup: names or designations, comma separated, e.g. Apophis, Bennu, 2024 YR4. Approaches: one designation. |
sort | string: date, dist, v-rel, h | Approaches sort. Default: "date". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/asteroid-close-approaches/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Bulk SEO Audit & PageSpeed / Core Web Vitals Checker API
Audit any list of URLs: Lighthouse performance, SEO, accessibility and best-practice scores, real-user Core Web Vitals (LCP, INP, CLS), speed opportunities, and on-page SEO checks (title, meta description, H1, canonical, alt text, sitemap, robots, schema)..
Canada Weather Alerts API
Public weather alerts for Canada from Environment and Climate Change Canada: warnings, watches, advisories and statements with alert name, type, risk colour, area, province, issue, validity, end and expiry times, confidence, impact and full text, in English or French..
CDC Notifiable Diseases API
CDC National Notifiable Diseases Surveillance System weekly tables: cases this week, 52-week maximum and year-to-date counts this and last year for measles, pertussis, Lyme disease, hepatitis, salmonellosis, tuberculosis and 100+ conditions by state, region and US total..
CDC PLACES API
CDC PLACES model-based local health estimates for every US county, city, ZIP code area and census tract: obesity, diabetes, high blood pressure, smoking, depression, insurance, checkups, disability, food insecurity and 40+ measures with confidence intervals and population..
EU Parliament MEPs API
Members of the European Parliament from the official EP Open Data Portal: MEP ID, full, given and family name, country of representation, political group and profile link.
Exoplanet API
Every confirmed exoplanet from the NASA Exoplanet Archive (Caltech/IPAC): orbit period and size, radius and mass, density, insolation, temperature, discovery method, year and facility, host star type, temperature, radius, mass, age, and distance.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com