Skip to content

USGS Earthquake Catalog API

Earthquake events as GeoJSON, filterable by time, magnitude and area.
Status
Working
API key
Not needed
Browser calls
Runs in the browser
Latency
432 ms

Build snapshot, not live. One verifier run on , from the machine that built this site. How we check

Example request

GEThttps://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1

Sent from your browser straight to earthquake.usgs.gov. No proxy: this site never sees the request or the answer.

Copy the request

Shell
curl -s 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1'

Response stored by the verifier

This is what earthquake.usgs.gov answered when the verifier sent the request above on : HTTP 200, application/json. Arrays are cut to two items and long strings are shortened. It comes from the build snapshot.

application/json · stored
{
  "type": "FeatureCollection",
  "metadata": {
    "generated": 1791018033000,
    "url": "https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1",
    "title": "USGS Earthquakes",
    "status": 200,
    "api": "2.7.0",
    "limit": 1,
    "offset": 1
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "mag": 0.8,
        "place": "57 km W of Happy Valley, Alaska",
        "time": 1791016886445,
        "updated": 1791016950229,
        "tz": null,
        "url": "https://earthquake.usgs.gov/earthquakes/eventpage/aka2026topkkf",
        "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=aka2026topkkf&format=geojson",
        "felt": null,
        "cdi": null,
        "mmi": null,
        "alert": null,
        "status": "automatic",
        "tsunami": 0,
        "sig": 10
      },
      "geometry": {
        "type": "Point",
        "coordinates": []
      },
      "id": "aka2026topkkf"
    }
  ]
}

Availability

Up 1 of 1 day checked · 30-day window

What counts as up for this API: an answer within five seconds, a 2xx status, and the JSON body must contain the field "features".

Last check: — passed, HTTP 200 in 432 ms.

The check runs from our infrastructure, not from where you are. If you need certainty, send the request yourself above. How the verifier works.

Questions

Does the USGS Earthquake Catalog API need an API key?

No. The sample request on this page was answered without a key, token or account.

Can I call the USGS Earthquake Catalog API from the browser?

Yes. earthquake.usgs.gov answered our verifier with an Access-Control-Allow-Origin header on Oct 3, 2026, so a fetch call from a web page can read the response.

Is the USGS Earthquake Catalog API working?

At the check on Oct 3, 2026 it returned HTTP 200 with the expected data in 432 ms. The status at the top of this page shows the most recent result we have.