Search earthquakes
Search USGS earthquake catalog by location, magnitude, depth, date range, and PAGER alert level. Full historical catalog available.
Query parameters
Start time (YYYY-MM-DD or ISO 8601).
Start time (YYYY-MM-DD or ISO 8601).
End time (YYYY-MM-DD or ISO 8601).
End time (YYYY-MM-DD or ISO 8601).
Minimum earthquake magnitude.
Minimum earthquake magnitude.
Maximum earthquake magnitude.
Maximum earthquake magnitude.
Latitude in decimal degrees (-90 to 90).
Latitude in decimal degrees (-90 to 90).
Longitude in decimal degrees (-180 to 180).
Longitude in decimal degrees (-180 to 180).
Search circle radius in km.
Search circle radius in km.
Minimum earthquake depth in km.
Minimum earthquake depth in km.
Maximum earthquake depth in km.
Maximum earthquake depth in km.
PAGER alert level: green, yellow, orange, red.
PAGER alert level: green, yellow, orange, red.
Maximum number of records to return.
Maximum number of records to return.
Sort criterion (time, time-asc, magnitude, magnitude-asc).
Sort criterion (time, time-asc, magnitude, magnitude-asc).
Response
Array of matching earthquake records from the USGS catalog.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}