Find Earthquakes
find-earthquakesRead-only
Search the USGS earthquake catalog by time, location, magnitude, and depth. Retrieve a summary of every matching seismic event.
Instructions
Search the USGS earthquake catalog by time, location, magnitude, and depth. Returns a summary of each matching event.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of events to return (service maximum 20000) | |
| endTime | No | Limit to events on or before this end time. Times use ISO8601 Date/Time format. Unless a timezone is specified, UTC is assumed. Defaults to NOW. | |
| orderby | No | Sort order. Defaults to time, most recent first. | |
| latitude | No | Latitude for a circular radius search | |
| maxdepth | No | Limit to events shallower than this, in kilometres | |
| mindepth | No | Limit to events deeper than this, in kilometres | |
| longitude | No | Longitude for a circular radius search | |
| startTime | No | Limit to events on or after this start time. Times use ISO8601 Date/Time format. Unless a timezone is specified, UTC is assumed. Defaults to NOW - 30 days. | |
| maxLatitude | No | Northern edge of a search rectangle. Minimum values must be less than maximum values. Requests that use both a rectangle and a circle return the intersection, which may be empty. | |
| maxradiuskm | No | Limit to events within this many kilometres of the latitude/longitude point | |
| minLatitude | No | Southern edge of a search rectangle. Minimum values must be less than maximum values. Requests that use both a rectangle and a circle return the intersection, which may be empty. | |
| maxLongitude | No | Eastern edge of a search rectangle. Minimum values must be less than maximum values. Requests that use both a rectangle and a circle return the intersection, which may be empty. | |
| maxmagnitude | No | Limit to events with at most this magnitude | |
| minLongitude | No | Western edge of a search rectangle. Rectangles may cross the date line using minLongitude < -180 or maxLongitude > 180. Minimum values must be less than maximum values. Requests that use both a rectangle and a circle return the intersection, which may be empty. | |
| minmagnitude | No | Limit to events with at least this magnitude |