Overview

The USGS Earthquake Hazards Program (EHP) serves as a primary source for earthquake information globally, tracking seismic activity and providing data for scientific research and public safety. Established in 1973, the program collects, processes, and disseminates real-time and historical earthquake data, including event locations, magnitudes, and focal mechanisms. Its mission extends to assessing earthquake hazards, conducting research into the causes and effects of earthquakes, and contributing to the development of earthquake-resistant infrastructure and emergency preparedness strategies.

Developers and technical buyers can utilize the EHP's various web services to integrate seismic data directly into their applications. These services adhere to the FDSN (International Federation of Digital Seismograph Networks) web service standards, ensuring interoperability with other global seismic data providers. This standardization is crucial for applications requiring access to a broad spectrum of seismic information, from real-time alerts to long-term geological trend analysis. For instance, developers can query recent earthquake events, access station metadata, or retrieve raw waveform data for in-depth analysis. The program is particularly suited for organizations involved in natural disaster response, urban planning, structural engineering, and academic research in seismology and geophysics.

The EHP's offerings are designed to support a range of use cases, from simple visualization of recent tremors on a map to complex scientific modeling of seismic wave propagation. Its data products include detailed catalog information, shake maps illustrating ground motion intensity, and seismic hazard maps that inform building codes and land-use planning. These resources are critical for developing early warning systems, conducting post-disaster assessments, and educating the public about earthquake risks. All data and API access provided by the USGS Earthquake Hazards Program are freely available, supporting open science and public benefit initiatives globally. The program's comprehensive data archives allow for historical analysis, which is vital for understanding seismic patterns and improving predictive models, as detailed in the USGS Earthquake Products documentation.

The program's data and APIs are widely used by academic institutions, government agencies, and private companies involved in risk assessment and infrastructure development. For example, emergency services use the real-time data to dispatch resources, while engineers consult seismic hazard maps to design resilient structures. Its focus on open data aligns with the broader principles of scientific transparency and collaboration, enabling a wide range of applications from public information tools to advanced research platforms. The Incorporated Research Institutions for Seismology (IRIS) Data Management Center, for instance, also provides similar data and services, further exemplifying the collaborative nature of global seismological data sharing.

Key features

  • Real-time Earthquake Data: Access current earthquake events, including location, magnitude, depth, and time of occurrence, updated continuously.
  • Historical Earthquake Catalog: Query a comprehensive database of past seismic events dating back decades, useful for trend analysis and research.
  • FDSN Web Services: Utilize standardized web services for events, stations, and waveforms, ensuring compatibility with international seismological data protocols, as described in the FDSN Event Web Service documentation.
  • ShakeMap Products: Obtain maps showing ground motion intensity immediately following significant earthquakes, critical for emergency response and damage assessment.
  • Seismic Hazard Maps: Access probabilistic seismic hazard maps that depict the likelihood of ground shaking exceeding certain thresholds, used for building codes and risk assessment.
  • Fault Data and Models: Explore geological fault lines and associated models relevant to earthquake generation.
  • Waveform Data Access: Retrieve raw seismic waveform data from monitoring stations for detailed seismological analysis.
  • Public Safety Information: Provides educational resources and information on earthquake preparedness for the general public and specific communities.

Pricing

The USGS Earthquake Hazards Program provides all its data, APIs, and services free of charge to the public and developers. There are no subscription fees, usage limits, or tiered access models for accessing real-time earthquake data, historical catalogs, or FDSN web services. This commitment to free and open access supports global scientific research, public safety initiatives, and educational efforts.

Service Tier Cost (as of 2026-05-28) Details
All Data & APIs Free Provides full access to real-time earthquake data, historical catalogs, FDSN web services (event, station, waveform), ShakeMaps, and seismic hazard products. No registration or API key required for basic access.

For more details on the available products and their accessibility, refer to the official USGS Earthquake Products page.

Common integrations

  • Geographic Information Systems (GIS): Integrate earthquake data into mapping platforms like ArcGIS to visualize seismic events in geographical context (e.g., ArcGIS Query Parameters documentation).
  • Custom Alert & Notification Systems: Build real-time alert systems for earthquake events, potentially integrating with communication platforms like Twilio for SMS/voice notifications (e.g., Twilio SMS API reference).
  • Web Applications & Dashboards: Display earthquake activity on public-facing websites or internal operational dashboards for ongoing monitoring.
  • Research & Analytics Platforms: Incorporate historical and real-time data into scientific modeling software and statistical analysis tools.
  • Disaster Preparedness Tools: Utilize ShakeMap and seismic hazard data within emergency management applications to inform response efforts and resource allocation.
  • Infrastructure Monitoring Systems: Integrate with systems monitoring critical infrastructure to assess potential impacts from seismic activity.

Alternatives

Getting started

Accessing data from the USGS Earthquake Hazards Program typically involves using their FDSN web services. Here's a basic Python example demonstrating how to retrieve a list of recent earthquakes using the FDSN Event Web Service:

import requests
import json

# Define the FDSN Event Web Service base URL
BASE_URL = "https://earthquake.usgs.gov/fdsnws/event/1/query"

# Define query parameters for recent significant earthquakes
# For example, all M2.5+ earthquakes in the last 7 days globally
params = {
    "format": "geojson",
    "starttime": "2026-05-21T00:00:00", # 7 days ago
    "endtime": "2026-05-28T23:59:59", # Today
    "minmagnitude": 2.5,
    "orderby": "time-desc"
}

print(f"Querying recent M2.5+ earthquakes from {params['starttime']} to {params['endtime']}...")

try:
    response = requests.get(BASE_URL, params=params)
    response.raise_for_status() # Raise an exception for HTTP errors

    data = response.json()

    if data and data['features']:
        print(f"Found {len(data['features'])} earthquakes.")
        print("--- Recent Earthquakes (Top 5) ---")
        for i, feature in enumerate(data['features'][:5]): # Display top 5
            properties = feature['properties']
            print(f"Event {i+1}:")
            print(f"  Time: {properties['time']}")
            print(f"  Magnitude: {properties['mag']}")
            print(f"  Place: {properties['place']}")
            print(f"  URL: {properties['url']}")
            print("----------------------------------")
    else:
        print("No earthquakes found for the specified criteria.")

except requests.exceptions.RequestException as e:
    print(f"An error occurred during the request: {e}")
except json.JSONDecodeError:
    print("Failed to decode JSON response.")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

This Python script uses the requests library to make an HTTP GET request to the USGS FDSN Event Web Service. It specifies parameters such as the desired output format (GeoJSON), a time range for events, a minimum magnitude, and orders the results by time. The response, which is in GeoJSON format, is then parsed to display details of the most recent earthquakes. This example illustrates how to programmatically access and process the data, forming a foundation for more complex applications. For full details on available parameters and response formats, consult the FDSN Event Web Service documentation.