What it returns
Official US volcano status from the USGS Volcano Hazards Program notification system (HANS), covering the Alaska, Cascades, Hawaiian, California and Yellowstone volcano observatories and the Northern Mariana Islands.
Common uses
Aviation and travel alerts, emergency management, news and hazard dashboards. Pay per row returned.
Request
POST https://api.pushbuild.com/usgs-volcano-alerts/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: elevated, notices, monitored | Elevated volcanoes, recent notices, or all monitored. Default: "elevated". |
observatories | string | Codes, comma separated: avo, cvo, hvo, calvo, yvo, nmi |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/usgs-volcano-alerts/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
Asteroid Close Approach API
NASA JPL data on near-Earth asteroids and comets: upcoming and past close approaches to Earth (distance in km and lunar distances, velocity, size estimate), the Sentry impact-risk list with probability and Palermo/Torino scales, and orbit and physical data for any object..
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.
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