x402

USGS Earthquake Search (x402)

Query the USGS earthquake catalogue by magnitude, date range and location radius: magnitude, place, time, coordinates, depth, tsunami flag, alert level and event page.

post/x402/v2/usgs-earthquake-search

Request

  • Base URL: https://api.strale.io
  • URL: https://api.strale.io/x402/v2/usgs-earthquake-search
  • Auth: none required

Request body

limitinteger

Events to return, 1-100. Default: 20

orderstring

time (newest first, default) or magnitude (largest first)

end_timestring

Latest event time, ISO date or datetime

latitudenumber

Centre latitude for a radius search (requires longitude)

longitudenumber

Centre longitude for a radius search (requires latitude)

start_timestring

Earliest event time, ISO date or datetime. Default: 30 days ago

max_magnitudenumber

Maximum magnitude

max_radius_kmnumber

Search radius around the centre in km. Default: 500

min_magnitudenumber

Minimum magnitude. Default: 4.5

Response

Success

countnumber
filtersobject

Example response

{
  "count": 1,
  "filters": {
    "order": "time",
    "end_time": null,
    "latitude": null,
    "longitude": null,
    "start_time": "2026-08-05",
    "max_magnitude": null,
    "max_radius_km": null,
    "min_magnitude": 5
  },
  "earthquakes": [
    {
      "id": "us7000te9t",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000te9t",
      "time": "2026-09-04T11:59:58.323Z",
      "place": "Kermadec Islands region",
      "status": "reviewed",
      "updated": "2026-09-04T12:19:40.040Z",
      "depth_km": 10,
      "latitude": -28.5616,
      "longitude": -176.6452,
      "magnitude": 5.4,
      "event_type": "earthquake",
      "alert_level": null,
      "felt_reports": null,
      "significance": 449,
      "magnitude_type": "mww",
      "tsunami_warning": false
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.