What it returns
Every earthquake in the USGS ComCat catalog, worldwide, from the official USGS Earthquake Hazards Program. Public domain.
Common uses
Risk and insurance analytics, logistics and supply-chain alerts, news, research and dashboards. Pay per event.
Request
POST https://api.pushbuild.com/usgs-earthquakes/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
feed | string: significant:month, 4.5:week, 4.5:day, 2.5:day, 1.0:hour, all:hour, all:day, significant:week, 4.5:month, 2.5:week | Use a live USGS summary feed instead of a search (magnitude:period). |
days | integer | Search the last N days when no start time is given. Default: 30. |
startTime | string | YYYY-MM-DD or ISO time (UTC). |
endTime | string | YYYY-MM-DD or ISO time (UTC). |
minMagnitude | number | e.g. 4.5 |
maxMagnitude | number | e.g. 9 |
minDepthKm | number | |
maxDepthKm | number | |
near | string | 'lat,lon' center for a radius search. |
radiusKm | number | With near; default 100, max 20001. |
boundingBox | string | 'minLat,minLon,maxLat,maxLon'. |
alertLevel | string: green, yellow, orange, red | Only events at this PAGER impact level. |
minFeltReports | integer | Only events felt by at least this many people. |
tsunamiOnly | boolean | Only events with a tsunami flag. Default: false. |
sort | string: time, time-asc, magnitude, magnitude-asc | Order of results. Default: "time". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/usgs-earthquakes/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.16 per 1,000 events. 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)..
FEC Campaign Finance (Candidates, PACs, Contributions) API
US federal campaign finance from official FEC bulk data: candidate receipts, spending, cash on hand and debts; PAC, super PAC and party committee totals; PAC and party contributions and independent expenditures for or against candidates.
Federal Register API
Search every Federal Register document since 1994: final and proposed rules, notices, executive orders and presidential documents, by keyword, agency, type, date and CFR part.
Google News Scraper API
Fast Google News results for any keyword, topic or country: title, source, publish time, snippet and link.
Google Trends Scraper API
Google Trends data for any keywords: interest over time, interest by country/state, related queries and topics (top and rising), plus today's trending searches.
Hacker News Scraper API
Search every Hacker News story and comment by keyword, date and points, or pull the live Top, New, Best, Ask, Show and Jobs feeds.
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