shipapis
StarSubmit an APISubmit API

USGS Earthquake Hazards Program

Real-time global earthquake feeds as GeoJSON

🔭 Science & SpaceUNMONITORED
AUTH NONECORS ✓AGENT ?HTTPS ✓COMMERCIAL ✓

The USGS FDSN event service streams earthquake catalogs going back decades, filterable by time, place, and magnitude. Ask for GeoJSON and you get tidy Features carrying location, depth, and shake metadata for every quake. No key, wide-open CORS, and it's U.S. government public-domain data.

—HOW IT'S SCORED ⓘ
▶ Run liveDocs ↗
Status badge · for your READMEshipapis health badge: — · unmonitored
ON PROBE SCHEDULE

We probe a documented GET and expect 2xx JSON — full uptime and health score. Open provider docs ↗

Uptime historystarts after first probe

On our probe schedule. Uptime charts appear after the first check lands.

Example responsefrom provider docs — not verified by us
GET https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1&starttime=2024-01-01&endtime=2024-01-02

{
  "type": "FeatureCollection",
  "metadata": {
    "generated": 1783247028000,
    "title": "USGS Earthquakes",
    "status": 200,
    "api": "2.7.0",
    "limit": 1
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "mag": 0.65,
        "place": "15 km S of Anza, CA",
        "time": 1704153354690,
        "magType": "ml",
        "type": "earthquake",
        "title": "M 0.7 - 15 km S of Anza, CA"
      }
    }
  ]
}
Call itcurl · fetch · python
curl "https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1&starttime=2024-01-01&endtime=2024-01-02"
const res = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1&starttime=2024-01-01&endtime=2024-01-02");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=1&starttime=2024-01-01&endtime=2024-01-02")
print(res.json())
Endpoints · 3On scheduleFULL DOCS ↗
On schedule — GET /query?format=geojson&limit=1&starttime=2024-01-01&endtime=2024-01-02 awaits first probe
GET/query?format=geojson&limit=1&starttime=2024-01-01&endtime=2024-01-02PROBED

Real-time global earthquake feeds as GeoJSON

GET/query?limit=5

Query — documented GET route.

GET/query?page=1

Query — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Not tracked yet. Shape-change history starts once this API joins our probe schedule.

USGS Earthquake Hazards Program: common questions

Is USGS Earthquake Hazards Program free to use?

Yes — USGS Earthquake Hazards Program is a free science & space API. Free tier: Free — no API key required. Commercial use is allowed on the free tier.

Does USGS Earthquake Hazards Program need an API key?

No — USGS Earthquake Hazards Program needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).

Can I call USGS Earthquake Hazards Program from the browser?

Yes — USGS Earthquake Hazards Program returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.

Is USGS Earthquake Hazards Program up right now?

USGS Earthquake Hazards Program is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.