U.S. Geological Survey

Earthquake Notifications, Feeds, and Web Services

The USGS Earthquake Hazards Program provides real-time notifications and historical earthquake data through the FDSN Event Web Service. Search the ANSS ComCat earthquake catalog by geography, time, magnitude, and depth. Responses available in GeoJSON, CSV, KML, and QuakeML formats.

GitHub OpenAPI

Documentation

📖
Documentation
https://earthquake.usgs.gov/fdsnws/event/1/
📖
GettingStarted
https://earthquake.usgs.gov/earthquakes/feed/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/openapi/usgs-earthquake-api-openapi.yaml

Examples

📝
Example
Earthquake Properties Example

Schemas & Data

📊
JSONSchema
Earthquake Properties Schema

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-ld/usgs-earthquake-api-context.jsonld
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/capabilities/usgs-earthquake-catalog.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/capabilities/usgs-earthquake-earthquakes.yaml

OpenAPI Specification

usgs-earthquake-api-openapi.yaml Raw ↑