Earthquakes near a point API

Pull recent quakes from the USGS GeoJSON feed (keyless) within a radius, compute the exact great-circle distance (Haversine) to each, sort nearest-first, and aggregate stats: count, strongest magnitude, nearest event, felt-report count and an aftershock count. The value-add is the radius filter, per-event distance and aggregate stats the raw feed doesn't give. Answers 'any earthquakes near me', 'quakes within 200km', 'closest recent earthquake', 'felt earthquakes nearby'.

Price$0.01per request

MethodPOST

Route/v1/science/earthquake-nearby

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

scienceearthquakeseismicusgshaversinedistancenearbyquake

API URLhttps://x402.hexl.dev/v1/science/earthquake-nearby

Integration docs

Example request

{
  "latitude": 34.0522,
  "longitude": -118.2437,
  "radiusKm": 200,
  "minMagnitude": 2.5,
  "days": 30
}

Example response

{
  "days": 30,
  "origin": {
    "latitude": 34.0522,
    "longitude": -118.2437
  },
  "radiusKm": 200,
  "minMagnitude": 2.5,
  "count": 3,
  "maxMagnitude": 4.1,
  "feltCount": 2,
  "aftershockCount": 1,
  "nearest": {
    "magnitude": 3.2,
    "place": "8km NE of Pasadena, CA",
    "distanceKm": 14.6,
    "time": "2026-05-30T11:04:21.000Z"
  },
  "earthquakes": [
    {
      "magnitude": 3.2,
      "place": "8km NE of Pasadena, CA",
      "time": "2026-05-30T11:04:21.000Z",
      "latitude": 34.18,
      "longitude": -118.07,
      "depthKm": 9.4,
      "felt": 120,
      "tsunami": false,
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/ci40000001",
      "distanceKm": 14.6
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        34.0522
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        -118.2437
      ]
    },
    "radiusKm": {
      "type": "number",
      "default": 300,
      "examples": [
        200
      ]
    },
    "minMagnitude": {
      "type": "number",
      "default": 0,
      "examples": [
        2.5
      ]
    },
    "days": {
      "type": "number",
      "default": 30,
      "examples": [
        30
      ]
    }
  }
}

Output schema

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