Sign up
All data sources

USGS Earthquakes

Unknown authusgs-earthquake

USGS Earthquake Hazards Program - real-time and historical seismicity data. Search earthquakes by location, magnitude, date range, or get significant events. CRITICAL USAGE RULES: 1. No authentication required 2. Use searchByRadius() for location-based seismicity analysis 3. Magnitude scale: 0-2 micro, 2-4 minor, 4-6 moderate, 6+ major 4. Coordinates are latitude/longitude in WGS84

Get this contract as JSONConnect this source →

Provenance

PublisherUSGS Earthquakes

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (5)

  • searchEarthquakes

    read

    Search earthquake events by time, location, magnitude, and result ordering.

    Input schema
    {
  "type": "object",
  "properties": {
    "starttime": {
      "type": "string"
    },
    "endtime": {
      "type": "string"
    },
    "minlatitude": {
      "type": "number"
    },
    "maxlatitude": {
      "type": "number"
    },
    "minlongitude": {
      "type": "number"
    },
    "maxlongitude": {
      "type": "number"
    },
    "minmagnitude": {
      "type": "number"
    },
    "maxmagnitude": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "orderby": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "time"
          ]
        },
        {
          "type": "string",
          "enum": [
            "time-asc"
          ]
        },
        {
          "type": "string",
          "enum": [
            "magnitude"
          ]
        },
        {
          "type": "string",
          "enum": [
            "magnitude-asc"
          ]
        }
      ]
    },
    "catalog": {
      "type": "string"
    },
    "contributor": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

  • searchByRadius

    read

    Search earthquake events near coordinates by radius, time, magnitude, catalog, and contributor.

    Input schema
    {
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "maxradiuskm": {
      "type": "number"
    },
    "starttime": {
      "type": "string"
    },
    "endtime": {
      "type": "string"
    },
    "minmagnitude": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "orderby": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "time"
          ]
        },
        {
          "type": "string",
          "enum": [
            "time-asc"
          ]
        },
        {
          "type": "string",
          "enum": [
            "magnitude"
          ]
        },
        {
          "type": "string",
          "enum": [
            "magnitude-asc"
          ]
        }
      ]
    },
    "catalog": {
      "type": "string"
    },
    "contributor": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "required": [
    "latitude",
    "longitude"
  ]
}

  • getSignificantEvents

    read

    List significant earthquake events identified by the earthquake data service.

    Input schema
    {
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

  • getEventDetail

    read

    Get one USGS earthquake event by its exact event ID.

    Input schema
    {
  "type": "object",
  "properties": {
    "eventid": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false,
  "required": [
    "eventid"
  ]
}

  • getRecentEvents

    read

    Get a real-time USGS feed by magnitude threshold and period.

    Input schema
    {
  "type": "object",
  "properties": {
    "minMagnitude": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "significant"
          ]
        },
        {
          "type": "number",
          "enum": [
            1,
            2.5,
            4.5
          ]
        }
      ]
    },
    "period": {
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month"
      ]
    }
  },
  "additionalProperties": false
}