Free Real-Time Global Earthquake Data API

Overview

Our Earthquake Data API provides free real-time access to earthquake information collected from around the world. The API is designed to be simple, fast, and reliable for developers building earthquake monitoring applications.

Real-time Data: Updated every minute with latest earthquake information

Global Coverage: Comprehensive data from worldwide monitoring networks

Free Access: No authentication or payment required

RESTful API: Standard HTTP methods and JSON responses

Base URL

https://earthqua.com/wp-json/earthquakes/v1/

Authentication

No authentication required. The API is publicly accessible for read-only operations.

Endpoints

Get Latest Earthquakes

GET /latest

Retrieve the most recent earthquake data with optional filtering parameters.

Parameters

Parameter	Type	Default	Description
`limit`	integer	10	Number of earthquakes to return (1-100)
`min_magnitude`	float	0	Minimum magnitude filter
`max_magnitude`	float	10	Maximum magnitude filter
`country_code`	string	null	Filter by country code (e.g., "TR", "US")
`keyword`	string	null	Search in place names

Example Requests

Get last 10 earthquakes
                        GET https://earthqua.com/wp-json/earthquakes/v1/latest
                    

Get earthquakes in Turkey with magnitude 4.0+
                        GET https://earthqua.com/wp-json/earthquakes/v1/latest?country_code=TR&min_magnitude=4.0
                    

Search for earthquakes containing "Turkey"
                        GET https://earthqua.com/wp-json/earthquakes/v1/latest?keyword=Turkey&limit=20
                    

Get Statistics

GET /stats

Retrieve earthquake statistics and summary information.

Example Request

GET https://earthqua.com/wp-json/earthquakes/v1/stats

Response Format

All API responses follow a consistent JSON structure:

Success Response

{
  "success": true,
  "data": {
    "earthquakes": [...],
    "total": 73,
    "page": 1,
    "per_page": 10,
    "total_pages": 8
  },
  "meta": {
    "generated_at": "2025-10-21T00:09:57+01:00",
    "api_version": "1.0",
    "source": "earthquakes-plugin"
  }
}

Earthquake Object

Each earthquake object contains the following fields:

Field	Type	Description
`id`	integer	Internal database ID
`external_id`	string	Source-specific identifier
`source`	string	Data source ("usgs" or "turkey")
`magnitude`	float	Earthquake magnitude
`magnitude_formatted`	string	Formatted magnitude (e.g., "4.2")
`magnitude_class`	string	Magnitude category ("low", "moderate", "strong", "major", "great")
`place`	string	Location description
`place_short`	string	Shortened location name
`latitude`	float	Latitude coordinate
`longitude`	float	Longitude coordinate
`depth`	float	Depth in kilometers
`depth_formatted`	string	Formatted depth (e.g., "7.5 km")
`time`	integer	Unix timestamp in milliseconds
`formatted_time`	string	Human-readable time
`coordinates`	string	Formatted coordinates
`status`	string	Review status
`tsunami_warning`	boolean	Tsunami warning issued
`city`	string	City name (if available)
`country`	string	Country name
`country_code`	string	ISO country code

Rate Limits

Currently, there are no rate limits imposed on the API. However, we recommend reasonable usage patterns to ensure optimal performance for all users.

Error Handling

Error responses follow the same structure as success responses but with success: false and an error message in the data field.

Data Quality

Authoritative Sources

Data collected from official government agencies and scientific institutions worldwide, ensuring accuracy and reliability.

Real-time Processing

Advanced algorithms process and validate earthquake data within minutes of occurrence, providing the most current information available.

Support

For API support, feature requests, or bug reports, please contact us through our website or create an issue in our repository.

Free Earthquake Data API