USGS Earthquake Risk Brief

Price: $0.05 per usable location earthquake risk brief.

Create bounded operational earthquake briefs around coordinates using the official USGS FDSN Event API.

Input

Provide locations with 1–5 objects containing opaque locationId, latitude and longitude, plus ISO startDate and exclusive endDate. locationId must match [A-Za-z0-9][A-Za-z0-9_-]{0,39}; spaces and free text are rejected. Date ranges are capped at 31 days. radiusKm is 1–2,000, minMagnitude is -2–10, maxEvents is 1–200 and maxItems defaults to one. Duplicate coordinates are analyzed once.

Output

Each report contains the opaque location ID, coordinates, radius and period; status and event count; magnitude bands; maximum and closest event summaries; tsunami and reviewed counts; up to 25 allowlisted event evidence rows; the exact query-bearing official source URL; reason; and fetch time. Evidence contains only event ID, magnitude, time, depth, computed distance, public USGS place label, tsunami flag, alert and review status. A verified empty GeoJSON response returns no_events; it does not assert that the location is safe.

Pricing

$0.05 per usable location report, charged exactly once as earthquake-brief-created by its atomic dataset push. A verified no-event report is usable and billable. Invalid coordinates or location IDs, identity inconsistency, truncation, authentication, rate-limit, timeout, redirect, response-size and GeoJSON structure failures emit no report and incur no event charge.

Limits

At most five sequential requests, one per selected location, with at least two seconds between requests, 200 source events, 25 evidence rows, a 4 MB response cap, 20 second HTTP timeout and 180 second run timeout. Reaching the configured event limit fails as truncated. Redirects are rejected. HTTP 401/403/451, 429, metadata disagreement, malformed features and invalid numbers fail explicitly. Runs use 256 MB without a browser or paid API.

Privacy

Only coordinates, an opaque 1–40 character locationId without spaces or free text, and public USGS event facts are processed. Street addresses, facility names, people, contacts, device data and raw source payloads are not accepted or retained. USGS-created data is public domain; USGS is attributed and does not endorse this independent product.