Pricing

from $1.00 / 1,000 earthquake fetcheds

USGS Earthquake Search

USGS Earthquake Search queries the United States Geological Survey (USGS) FDSN Event Web Service to retrieve structured earthquake data from the world's most comprehensive seismic event database.

Pricing

from $1.00 / 1,000 earthquake fetcheds

Rating

0.0

(0)

Developer

ryan clinton

Actor stats

Bookmarked

Total users

Monthly active users

4 days ago

Last modified

Categories

Developer tools

You can access the USGS Earthquake Search programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "Y3VpeZMa6NbSSRNdJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ryanclinton~usgs-earthquake-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ryanclinton-usgs-earthquake-search",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/ryanclinton~usgs-earthquake-search/runs": {
      "post": {
        "operationId": "runs-sync-ryanclinton-usgs-earthquake-search",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/ryanclinton~usgs-earthquake-search/run-sync": {
      "post": {
        "operationId": "run-sync-ryanclinton-usgs-earthquake-search",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "starttime": {
            "title": "Start Date",
            "type": "string",
            "description": "Search earthquakes from this date (YYYY-MM-DD format)"
          },
          "endtime": {
            "title": "End Date",
            "type": "string",
            "description": "Search earthquakes until this date (YYYY-MM-DD). Leave empty for latest."
          },
          "minmagnitude": {
            "title": "Minimum Magnitude",
            "type": "number",
            "description": "Minimum earthquake magnitude (e.g. 4.0 for moderate, 6.0 for strong)"
          },
          "maxmagnitude": {
            "title": "Maximum Magnitude",
            "type": "number",
            "description": "Maximum earthquake magnitude"
          },
          "latitude": {
            "title": "Center Latitude",
            "type": "number",
            "description": "Latitude for radius search (use with longitude and maxradiuskm)"
          },
          "longitude": {
            "title": "Center Longitude",
            "type": "number",
            "description": "Longitude for radius search (use with latitude and maxradiuskm)"
          },
          "maxradiuskm": {
            "title": "Radius (km)",
            "type": "number",
            "description": "Search radius in km from center point (max 20001)"
          },
          "mindepth": {
            "title": "Min Depth (km)",
            "type": "number",
            "description": "Minimum depth in km"
          },
          "maxdepth": {
            "title": "Max Depth (km)",
            "type": "number",
            "description": "Maximum depth in km"
          },
          "alertlevel": {
            "title": "Alert Level",
            "enum": [
              "green",
              "yellow",
              "orange",
              "red"
            ],
            "type": "string",
            "description": "Filter by PAGER alert level"
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Maximum number of earthquakes to return (API max: 20000)",
            "default": 100
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

USGS Earthquake Search - Global Seismic Data API OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for USGS Earthquake Search from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

USGS Earthquake Search API in Python

USGS Earthquake Search API in JavaScript

USGS Earthquake Search API through CLI

USGS Earthquake Search API

Usgs Earthquake Scraper

fortuitous_pirate/usgs-earthquake-scraper

Fortuitous Pirate

USGS Earthquake Scraper

professional-edge/usgs-earthquake-scraper

Extract structured earthquake event data from the USGS Earthquake Hazards Program, the authoritative source for seismic activity worldwide.

Professional Edge

Usgs Earthquake Scraper

automation-lab/usgs-earthquake-scraper

Extract real-time and historical earthquake data from USGS. Get magnitude, location, depth, timestamps, and alert levels for seismic events worldwide. Monitor earthquake activity, build alert systems, and analyze seismological patterns.

Stas Persiianenko

USGS Earthquake Tracker

martc03/earthquake-tracker

Tracks earthquakes worldwide using the USGS Earthquake Hazards API. Filter by magnitude, date range, and geographic region. Real-time seismic data.

CoDee

USGS Earthquake Data Scraper

cloud9_ai/usgs-earthquake-scraper

Extract real-time and historical earthquake data from USGS. Get magnitude, location, depth, and tsunami warnings. No API key needed.

cloud9

USGS Earthquake Intelligence

benthepythondev/earthquake-intelligence

Real-time earthquake data from USGS. Get magnitude, location, depth, tsunami warnings, and shake intensity for recent seismic events worldwide. Filter by region, magnitude, and time period. Perfect for researchers, emergency services, insurance, and news organizations.

ben

Usgs Water Scraper

fortuitous_pirate/usgs-water-scraper

Fortuitous Pirate

Natural Disaster Intelligence MCP Server

martc03/natural-disaster-intel-mcp

MCP server for natural disaster data. Gives AI assistants access to FEMA disaster declarations, NOAA weather alerts, and USGS earthquake data in real-time.

CoDee

Location Risk Report

ryanclinton/location-risk-report

Comprehensive location risk assessment tool that combines up to 15 data sources — FEMA disaster declarations, USGS earthquake data, NOAA weather alerts, GDACS global disasters, UK flood warnings, EPA ECHO enforcement, OpenAQ air quality, crime statistics, OpenStreetMap points of interest, EV...

ryan clinton

Insurance Risk Assessment

ryanclinton/insurance-risk-assessment

Comprehensive insurance underwriting intelligence tool that combines 8 data sources — FEMA disaster declarations, USGS earthquake data, NOAA weather alerts, UK flood warnings, UK police crime data, OpenAQ air quality measurements, UK Land Registry property records, and geocoding — to produce a...

ryan clinton