Geoscience & Environment · Data API

Global Significant Earthquakes

A global feed of significant earthquake events, updated in near real-time.

Provides magnitude, location, depth, and impact metadata for major earthquakes worldwide. Critical data for insurance, reinsurance, disaster response organizations, and global supply chain risk management.

Source: USGS Earthquake Catalog · Public Domain · U.S. Geological Survey

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/global-significant-earthquakes
  • GET /v1/data/global-significant-earthquakes/search?q=...
  • GET /v1/data/global-significant-earthquakes/{key}

Base path /v1/data/global-significant-earthquakes · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
event_idstrThe unique identifier for the earthquake event.
event_time_utcstrThe time the event occurred in ISO 8601 format (UTC).
latitudefloatThe latitude of the earthquake's epicenter.
longitudefloatThe longitude of the earthquake's epicenter.
depth_kmfloatThe depth of the event in kilometers.
magnitudefloatThe magnitude of the earthquake.
magnitude_typestrThe method or scale used to calculate magnitude (e.g., 'mw', 'ml').
place_descriptionstrA human-readable description of the event's location.
tsunami_alertintIndicates if a tsunami alert was issued (1 for yes, 0 for no).
statusstrThe review status of the event, e.g., 'automatic' or 'reviewed'.

What you get

Data sourced directly from the authoritative USGS feed.
Includes all significant global earthquakes.
Updated every 5 minutes.
Rich metadata including depth, magnitude type, and tsunami alerts.
Clean, consistent, and easy-to-use format.

FAQ

What does 'significant' mean?
The USGS defines 'significant' based on a combination of magnitude, location, and felt reports, indicating a higher potential for impact.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"