Regional seismicity statistics API

Aggregates USGS earthquakes for a region (bbox or center+radius) and period into count, max magnitude, total released energy (joules + TNT-equivalent via the Gutenberg-Richter relation), and a magnitude histogram. Answers 'How seismically active is this area?', 'What is the total earthquake energy released here this month?', 'What is the magnitude distribution near this point?'.

Price$0.01per request

MethodPOST

Route/v1/science/seismicity

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

scienceseismicityearthquakeearthquakesusgsseismic-energymagnitudegeophysics

API URLhttps://x402.hexl.dev/v1/science/seismicity

Integration docs

Example request

{
  "latitude": 35.7,
  "longitude": -117.6,
  "radiusKm": 300,
  "days": 30,
  "minMagnitude": 2.5
}

Example response

{
  "periodDays": 30,
  "region": "radius",
  "count": 47,
  "maxMagnitude": 4.6,
  "meanMagnitude": 3.01,
  "totalEnergyJoules": 501200000000,
  "totalEnergyTntTons": 119.8,
  "largest": {
    "magnitude": 4.6,
    "place": "12km SW of Searles Valley, CA",
    "time": "2024-05-18T04:22:11.000Z",
    "longitude": -117.61,
    "latitude": 35.69,
    "depthKm": 6.2,
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/ci40012345"
  },
  "histogram": {
    "2-3": 28,
    "3-4": 15,
    "4-5": 4
  }
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "examples": [
        35.7
      ]
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "examples": [
        -117.6
      ]
    },
    "radiusKm": {
      "type": "number",
      "minimum": 1,
      "maximum": 20000,
      "examples": [
        300
      ]
    },
    "minLat": {
      "type": "number",
      "examples": [
        32
      ]
    },
    "maxLat": {
      "type": "number",
      "examples": [
        42
      ]
    },
    "minLon": {
      "type": "number",
      "examples": [
        -124
      ]
    },
    "maxLon": {
      "type": "number",
      "examples": [
        -114
      ]
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "examples": [
        30
      ]
    },
    "minMagnitude": {
      "type": "number",
      "examples": [
        2.5
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}