Data and APIs
Sign InGet Started
Earthquakes API
DataMAINTAINED1 token / call

Earthquakes API

311,590 earthquakes of magnitude 4.5 and above since 1900 from USGS, with nearby and largest lookups, daily

Every recorded earthquake worldwide of magnitude 4.5 or greater since 1900 — 311,590 events from the USGS ComCat catalog, refreshed daily. Each event carries precise time, coordinates, depth, magnitude with its type, a human-readable place, review status and a link to the USGS event page. The largest endpoint reads like seismology history: 1960 Chile M9.5, 1964 Alaska M9.2, 2011 Tohoku and 2004 Sumatra at M9.1. The nearby endpoint answers location questions in one call — 300 km around Tokyo at M7+ surfaces the 1923 Great Kanto earthquake 55 km out and the 2011 megathrust; search filters cover magnitude range, place, and dates (California at M6+: 1,072 events, led by the 1906 San Francisco quake). New events land daily and USGS''s post-event magnitude revisions flow in automatically via a rolling re-upsert window. Built for dashboards and news widgets, insurance and catastrophe models, education, and any product that needs seismic history plus a live feed behind one key. Public-domain source data, self-hosted — no third-party calls at request time.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans
No credit card requiredAccess to 125+ APIsCancel anytime
response.json
{
  "ok": true,
  "year": 2011,
  "count": 3,
  "results": [
    {
      "id": "official20110311054624120_30",
      "time": "2011-03-11T05:46:24.120Z",
      "magnitude": 9.1,
      "magnitude_type": "mww",
      "place": "2011 Great Tohoku Earthquake, Japan",
      "latitude": 38.297,
      "longitude": 142.373,
      "depth_km": 29,
      "type": "earthquake",
      "status": "reviewed",
      "network": "official",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/official20110311054624120_30"
    },
    {
      "id": "usp000hvpa",
      "time": "2011-03-11T06:15:40.280Z",
      "magnitude": 7.9,
      "magnitude_type": "mwc",
      "place": "47 km E of ?arai, Japan",
      "latitude": 36.281,
      "longitude": 141.111,
      "depth_km": 42.6,
      "type": "earthquake",
      "status": "reviewed",
      "network": "us",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpa"
    },
    {
      "id": "usp000hvpg",
      "time": "2011-03-11T06:25:50.300Z",
      "magnitude": 7.7,
      "magnitude_type": "mwc",
      "place": "272 km ESE of Kamaishi, Japan",
      "latitude": 38.058,
      "longitude": 144.59,
      "depth_km": 18.6,
      "type": "earthquake",
      "status": "reviewed",
      "network": "us",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpg"
    }
  ]
}
Production Ready
Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration
Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs
Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Earthquakes API

  • Show recent earthquakes near a user's location with magnitude, depth and distance.

  • Alert insurers, logistics or facilities teams to significant quakes within a radius of their assets.

  • Build historical maps and charts of seismic activity by region or year.

  • List the largest events on record for education, journalism or risk communication.

Earthquakes API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definitionPostman workspace

GETData Sources

https://api-earthquakes.dataandapis.com/v1/sources

This endpoint takes no parameters.

Example request

curl "https://api-earthquakes.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "ok": true,
  "coverage": "USGS ComCat, M4.5+ worldwide, 1900-present (daily refresh)",
  "count": 1,
  "sources": [
    {
      "slug": "usgs-comcat",
      "name": "USGS ComCat M4.5+ worldwide 1900-present",
      "publisher": "US Geological Survey",
      "licence": "US Government work - public domain",
      "source_url": "https://earthquake.usgs.gov/data/comcat/",
      "file_url": "https://earthquake.usgs.gov/fdsnws/event/1/query?format=csv",
      "cadence": "continuous (daily refresh)",
      "record_count": 311590,
      "retrieved_at": "2026-09-06"
    }
  ]
}

GETEarthquakes Near A Point

https://api-earthquakes.dataandapis.com/v1/earthquakes/nearby

Query parameters

ParameterExample
lat35.68Required
limit25Optional
lon139.69Required
min_magnitude7Optional
radius300Optional

Example request

curl "https://api-earthquakes.dataandapis.com/v1/earthquakes/nearby?lat=35.68&limit=25&lon=139.69&min_magnitude=7&radius=300" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "ok": true,
  "lat": 35.68,
  "lon": 139.69,
  "radius_km": 300,
  "count": 3,
  "results": [
    {
      "id": "iscgem911526",
      "time": "1923-09-01T02:58:35.270Z",
      "magnitude": 7.96,
      "magnitude_type": "mw",
      "place": "5 km SSE of ?iso, Japan",
      "latitude": 35.274,
      "longitude": 139.344,
      "depth_km": 15,
      "type": "earthquake",
      "status": "reviewed",
      "network": "iscgem",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/iscgem911526",
      "distance_km": 55
    },
    {
      "id": "iscgem892187",
      "time": "1953-11-25T17:48:55.090Z",
      "magnitude": 7.9,
      "magnitude_type": "mw",
      "place": "174 km SE of Katsuura, Japan",
…
Show full response
{
  "ok": true,
  "lat": 35.68,
  "lon": 139.69,
  "radius_km": 300,
  "count": 3,
  "results": [
    {
      "id": "iscgem911526",
      "time": "1923-09-01T02:58:35.270Z",
      "magnitude": 7.96,
      "magnitude_type": "mw",
      "place": "5 km SSE of ?iso, Japan",
      "latitude": 35.274,
      "longitude": 139.344,
      "depth_km": 15,
      "type": "earthquake",
      "status": "reviewed",
      "network": "iscgem",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/iscgem911526",
      "distance_km": 55
    },
    {
      "id": "iscgem892187",
      "time": "1953-11-25T17:48:55.090Z",
      "magnitude": 7.9,
      "magnitude_type": "mw",
      "place": "174 km SE of Katsuura, Japan",
      "latitude": 34.006,
      "longitude": 141.625,
      "depth_km": 25,
      "type": "earthquake",
      "status": "reviewed",
      "network": "iscgem",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/iscgem892187",
      "distance_km": 256.6
    },
    {
      "id": "usp000hvpa",
      "time": "2011-03-11T06:15:40.280Z",
      "magnitude": 7.9,
      "magnitude_type": "mwc",
      "place": "47 km E of ?arai, Japan",
      "latitude": 36.281,
      "longitude": 141.111,
      "depth_km": 42.6,
      "type": "earthquake",
      "status": "reviewed",
      "network": "us",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpa",
      "distance_km": 144.3
    }
  ]
}

GETGet Earthquake

https://api-earthquakes.dataandapis.com/v1/earthquakes/{id}

Path parameters

ParameterExample
idus6000jlqaRequired

Example request

curl "https://api-earthquakes.dataandapis.com/v1/earthquakes/us6000jlqa" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "ok": true,
  "earthquake": {
    "id": "us6000jlqa",
    "time": "2023-02-06T10:24:48.811Z",
    "magnitude": 7.5,
    "magnitude_type": "mww",
    "place": "Elbistan earthquake, Kahramanmaras earthquake sequence",
    "latitude": 38.0106,
    "longitude": 37.1962,
    "depth_km": 7.432,
    "type": "earthquake",
    "status": "reviewed",
    "network": "us",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000jlqa"
  }
}

GETLargest Earthquakes

https://api-earthquakes.dataandapis.com/v1/earthquakes/largest

Query parameters

ParameterExample
limit10Optional
year2011Optional

Example request

curl "https://api-earthquakes.dataandapis.com/v1/earthquakes/largest?limit=10&year=2011" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "ok": true,
  "year": 2011,
  "count": 3,
  "results": [
    {
      "id": "official20110311054624120_30",
      "time": "2011-03-11T05:46:24.120Z",
      "magnitude": 9.1,
      "magnitude_type": "mww",
      "place": "2011 Great Tohoku Earthquake, Japan",
      "latitude": 38.297,
      "longitude": 142.373,
      "depth_km": 29,
      "type": "earthquake",
      "status": "reviewed",
      "network": "official",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/official20110311054624120_30"
    },
    {
      "id": "usp000hvpa",
      "time": "2011-03-11T06:15:40.280Z",
      "magnitude": 7.9,
      "magnitude_type": "mwc",
      "place": "47 km E of ?arai, Japan",
      "latitude": 36.281,
      "longitude": 141.111,
      "depth_km": 42.6,
…
Show full response
{
  "ok": true,
  "year": 2011,
  "count": 3,
  "results": [
    {
      "id": "official20110311054624120_30",
      "time": "2011-03-11T05:46:24.120Z",
      "magnitude": 9.1,
      "magnitude_type": "mww",
      "place": "2011 Great Tohoku Earthquake, Japan",
      "latitude": 38.297,
      "longitude": 142.373,
      "depth_km": 29,
      "type": "earthquake",
      "status": "reviewed",
      "network": "official",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/official20110311054624120_30"
    },
    {
      "id": "usp000hvpa",
      "time": "2011-03-11T06:15:40.280Z",
      "magnitude": 7.9,
      "magnitude_type": "mwc",
      "place": "47 km E of ?arai, Japan",
      "latitude": 36.281,
      "longitude": 141.111,
      "depth_km": 42.6,
      "type": "earthquake",
      "status": "reviewed",
      "network": "us",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpa"
    },
    {
      "id": "usp000hvpg",
      "time": "2011-03-11T06:25:50.300Z",
      "magnitude": 7.7,
      "magnitude_type": "mwc",
      "place": "272 km ESE of Kamaishi, Japan",
      "latitude": 38.058,
      "longitude": 144.59,
      "depth_km": 18.6,
      "type": "earthquake",
      "status": "reviewed",
      "network": "us",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpg"
    }
  ]
}

GETSearch Earthquakes

https://api-earthquakes.dataandapis.com/v1/earthquakes

Query parameters

ParameterExample
date_from2023-01-01Optional
date_to2023-12-31Optional
limit20Optional
max_magnitude9.5Optional
min_magnitude6Optional
page1Optional
placeCaliforniaOptional
sortmagnitudeOptional

Example request

curl "https://api-earthquakes.dataandapis.com/v1/earthquakes?date_from=2023-01-01&date_to=2023-12-31&limit=20&max_magnitude=9.5&min_magnitude=6&page=1&place=California&sort=magnitude" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "ok": true,
  "total": 102,
  "page": 1,
  "limit": 20,
  "count": 3,
  "results": [
    {
      "id": "official19060418131226300_12",
      "time": "1906-04-18T13:12:26.300Z",
      "magnitude": 7.9,
      "magnitude_type": "mw",
      "place": "The 1906 San Francisco, California Earthquake",
      "latitude": 37.75,
      "longitude": -122.55,
      "depth_km": 11.7,
      "type": "earthquake",
      "status": "reviewed",
      "network": "official",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/official19060418131226300_12"
    },
    {
      "id": "ci3319401",
      "time": "1952-07-21T11:52:14.540Z",
      "magnitude": 7.5,
      "magnitude_type": "mw",
      "place": "The 1952 Kern County, California Earthquake",
      "latitude": 34.9582,
…
Show full response
{
  "ok": true,
  "total": 102,
  "page": 1,
  "limit": 20,
  "count": 3,
  "results": [
    {
      "id": "official19060418131226300_12",
      "time": "1906-04-18T13:12:26.300Z",
      "magnitude": 7.9,
      "magnitude_type": "mw",
      "place": "The 1906 San Francisco, California Earthquake",
      "latitude": 37.75,
      "longitude": -122.55,
      "depth_km": 11.7,
      "type": "earthquake",
      "status": "reviewed",
      "network": "official",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/official19060418131226300_12"
    },
    {
      "id": "ci3319401",
      "time": "1952-07-21T11:52:14.540Z",
      "magnitude": 7.5,
      "magnitude_type": "mw",
      "place": "The 1952 Kern County, California Earthquake",
      "latitude": 34.9582,
      "longitude": -118.998,
      "depth_km": 6,
      "type": "earthquake",
      "status": "reviewed",
      "network": "ci",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/ci3319401"
    },
    {
      "id": "iscgem911811",
      "time": "1922-01-31T13:17:31.440Z",
      "magnitude": 7.41,
      "magnitude_type": "mw",
      "place": "123 km W of Big Lagoon, California",
      "latitude": 41.189,
      "longitude": -125.608,
      "depth_km": 15,
      "type": "earthquake",
      "status": "reviewed",
      "network": "iscgem",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/iscgem911811"
    }
  ]
}

Where the data comes from

Source
USGS ComCat earthquake catalog, magnitude 4.5 and above since 1900 (public domain).
Freshness
Daily refresh over a 14-day window.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages
5endpoints
RESTarchitecture
1key for all APIs
  • Fully typed responses — auto-completion in your IDE
  • Tracks the API in lockstep — new endpoints land same day
  • One key works across 125+ APIs on the platform
import axios from 'axios';

const { data } = await axios.get(
  'https://api-earthquakes.dataandapis.com/v1/sources',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Earthquakes API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key
import axios from 'axios';

const url = 'https://api-earthquakes.dataandapis.com/v1/sources';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

One subscription. Every API.

Tokens unlock this API and 125+ others on DataAndAPIs. Switch APIs any time — we promote.

FREE

$0/mo

500 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Community support
Start free
Most Popular

STARTER

$6.99/mo

25,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Email support
Subscribe

PRO

$24.99/mo

100,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Priority email support
Subscribe

ULTRA

$99.99/mo

1,000,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Priority support
Subscribe

Need higher volume, dedicated infra, or a custom contract? Talk to sales →

Questions about Earthquakes API

APIs often used with Earthquakes API

Ship Earthquakes API this afternoon.

500 free tokens. No card. Plus 125+ other APIs on the same key.

Get API key →Browse all APIs