AkashiDocs
Providers

USGS Earthquakes

Real-time earthquake catalogue from the US Geological Survey: magnitude, place, depth, time, tsunami flag.

  • Provider id: usgs
  • Tools: 1, at $0.001 per call
  • Categories: Weather & Earth, Science & Health
  • Homepage: earthquake.usgs.gov
  • Provider docs: earthquake.usgs.gov/fdsnws/event/1
  • Licence: Public domain (US Government work)
  • Attribution: U.S. Geological Survey, Earthquake Hazards Program
ToolPriceWhat it does
usgs/earthquakes$0.001Recent earthquakes worldwide or within a radius of a point: magnitude, place, time, depth, tsunami flag.

Inputs are JSON bodies, and unknown fields are rejected with 422 invalid_input (not charged). POST /v1/inspect with a tool's id returns the same input schema, plus the output schema.

USGS Recent Earthquakes

usgs/earthquakes · $0.001 per call (local) · Weather & Earth, Science & Health

Recent earthquakes worldwide or within a radius of a point: magnitude, place, time, depth, tsunami flag.

Lists earthquakes from the USGS real-time catalogue for the past hour, day, week or 30 days, above a minimum magnitude, newest or strongest first; give latitude/longitude (and radius_km) to search around a place. Each row has UTC time, magnitude, place, depth, coordinates, the tsunami flag, PAGER alert level and the USGS event page. Coverage is global for M4.5+, and dense for smaller quakes mainly in the US. It does not forecast quakes or issue tsunami warnings; check official agencies for those.

Related: openweather/current, wikipedia/summary.

Input

FieldTypeRequiredDescription
periodstringnoHow far back: the past hour, day, week or 30 days. One of hour, day, week, month. Default "day".
min_magnitudenumbernoFrom 0 to 10. Default 2.5.
latitudenumbernoCentre of a search circle. From -90 to 90.
longitudenumbernoFrom -180 to 180.
radius_kmnumbernoCircle radius around the point. At most 20001.6. Greater than 0. Default 300.
orderstringnoOne of newest, strongest. Default "newest".
limitintegernoFrom 1 to 50. Default 10.

Example

Input
{
  "period": "day",
  "min_magnitude": 4.5,
  "limit": 10
}
Run it with the CLI
node akashi.mjs run usgs/earthquakes --input '{"period":"day","min_magnitude":4.5,"limit":10}'

On this page