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:
Parameter | Description | Default 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