GetEarthquakeCatalog API

The GetEarthquakeCatalog API returns earthquake events from our custom catalog. This catalog is created by merging data feeds from various global sources and is what we use to create our forecasts.

The GetEarthquakeCatalog Web Service is located at: http://api.openhazards.com/GetEarthquakeCatalog.

The parameters of the API are:

ParameterDescriptionDefault Value
t0 Starting date for the catalog. 1980/01/01 00:00:00
t1 Ending date for the catalog. Current Date/Time
x0 Minimum longitude for the catalog (degrees). -180
x1 Maximum longitude for the catalog (degrees). 180
y0 Minimum latitude for the catalog (degrees). -90
y1 Maximum latitude for the catalog (degrees). 90
z0 Minimum depth for the catalog (km). 0
z1 Maximum depth for the catalog (km). 1000
m0 Minimum magnitude for the catalog. 2.5
m1 Maximum magnitude for the catalog. 10
limit Maximum number of events to return (counted backwards from t1). Negative numbers return all results. -1

The results returned by the API are:

A list of earthquake events, one per line.

  • Date
  • Time
  • Latitude
  • Longitude
  • Depth
  • Magnitude

Example

The following request will return all of the magnitude 5.8 and above earthquakes in the California region since 1 Jan 2000.

Request:

http://api.openhazards.com/GetEarthquakeCatalog?t0=2000/1/1&m0=5.8&x0=-125&x1=-113&y0=32&y1=42

Response:

2001/12/08 23:36:10.660000 32.038 -114.906 10.0 5.8
2003/12/22 19:15:56.240000 35.7005 -121.101 8.7 6.5
2004/09/28 17:15:24.250000 35.8182 -120.366 8.58 5.97
2008/02/21 14:16:02.710000 41.153 -114.867 6.7 6.0
2009/12/30 18:48:57.330000 32.464 -115.189 6.0 5.8
2010/01/10 00:27:39.320000 40.652 -124.692 29.33 6.5
2010/02/04 20:20:21.970000 40.4123 -124.961 23.63 5.88
2010/04/04 22:40:42.360000 32.2862 -115.295 10.0 7.2
Risk Alert