Skip to main content
All providers

USGS Earthquake Catalog

GeoUS

earthquake.usgs.gov

Every earthquake in the USGS ComCat catalogue, queryable by time, place and magnitude.

Capabilities (7)

GET /v1/data/usgs/catalogs1 credit

Returns the service's own vocabularies: every valid catalog id, contributor id, product type, event type and magnitude type.

No parameters
GET /v1/data/usgs/count1 credit

Returns just {count, maxAllowed} for the same filters the search accepts, with no event payload.

starttime?endtime?updatedafter?minmagnitude?maxmagnitude?mindepth?maxdepth?latitude?longitude?maxradiuskm?minradiuskm?minlatitude?maxlatitude?minlongitude?maxlongitude?alertlevel?eventtype?catalog?contributor?reviewstatus?minsig?limit?offset?orderby?
GET /v1/data/usgs/event1 credit

Returns one earthquake as a GeoJSON Feature including the full product list - ShakeMap, DYFI, PAGER, moment tensor, origin and finite fault - with links to each product's files.

eventidincludeallorigins?includeallmagnitudes?includedeleted?
GET /v1/data/usgs/feed1 credit

Returns a pre-built, cached GeoJSON FeatureCollection of recent earthquakes for a fixed magnitude threshold and time window, updated every minute.

feed
GET /v1/data/usgs/places1 credit

Returns the nearest populated places to a latitude/longitude as GeoJSON, each with name, country, population, distance in km and azimuth, which is how USGS writes the '12 km W of Rio Grande' strings.

latitudelongitudetype?limit?maxradiuskm?minpopulation?
GET /v1/data/usgs/query1 credit

Returns matching earthquakes as a GeoJSON FeatureCollection, one feature per event with magnitude, place, time, depth, coordinates, felt reports, tsunami flag and the event page URL.

starttime?endtime?updatedafter?minmagnitude?maxmagnitude?mindepth?maxdepth?latitude?longitude?maxradiuskm?minradiuskm?minlatitude?maxlatitude?minlongitude?maxlongitude?alertlevel?eventtype?catalog?contributor?reviewstatus?minsig?limit?offset?orderby?
GET /v1/data/usgs/regions1 credit

Returns every USGS region a point falls in as GeoJSON: administrative country and subdivision, the authoritative seismic network, Flinn-Engdahl region, tectonic summary and offshore status.

latitudelongitudetype?

Licence

A work of the United States Government, not subject to domestic copyright under 17 U.S.C. 105, published by the agency as open data.

https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: U.S. Geological Survey

Cache: up to 300s