apyhub
Back
▣ GEOLOCATION · STANDARD DATA

Retrieve USGS Earthquake Data API

What it does

USGS Earthquake Data returns earthquake records from the USGS feed for a time window you define. Send a starttime and endtime, and optionally filter by minmagnitude and limit.

Use it when you need recent seismic events for dashboards, alerts, research workflows, or map visualisations. The endpoint is built around query parameters, so it fits cleanly into scheduled jobs and lightweight backend services.

The response schema is open-ended, so the service returns a structured JSON object with the earthquake data available from the source response. In practice, that lets you treat the endpoint as a retrieval layer for USGS event data without having to wire up the feed directly.

If you are building monitoring tools, compliance checks, or location-based analysis, USGS Earthquake Data gives you a simple way to fetch events for a specific date range and magnitude threshold.

GET
USGS earthquakes
https://api.eu.apyhub.com/dosvak/usgs-earthquakes

QUICKSTART

GUIDE

Quickstart

Fetch USGS earthquake data for a date range using the required query parameters.

curl -X GET "https://api.eu.apyhub.com/dosvak/usgs-earthquakes?starttime=2026-07-01&endtime=2026-07-28" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The schema does not declare any specific top-level fields, so the response shape may vary.

{
  "count": 2,
  "results": [
    {
      "id": "event_12345",
      "time": 1753690200000,
      "place": "Sample Location",
      "magnitude": 5.2,
      "latitude": 35.1234,
      "longitude": -117.4567,
      "depth_km": 10.5,
      "status": "reviewed"
    }
  ],
  "attribution": [
    {
      "source": "USGS"
    }
  ]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves USGS earthquake data for a specified time range, with optional filtering by result limit and minimum magnitude. The response schema is not yet defined beyond a JSON object, so the exact fields returned are not captured here.

Query Parameter(s)

AttributeTypeDescription
limitIntegerMaximum number of results to return.
Default: 100.
Minimum: 1.
Maximum: 1000.
endtimeStringEnd of the time range to query.
starttimeStringStart of the time range to query.
minmagnitudeNumberMinimum earthquake magnitude to include.
Default: 4.5.
Minimum: 0.
Maximum: 10.

Response

Returns a JSON object. The schema allows additional properties, but it does not define any concrete top-level fields, so the exact response shape is not specified yet.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLUS State Climate Summary APIDosvak LLCCALLRetrieve World Bank Public Data APIDosvak LLCCALLUS County Climate Profile APIDosvak LLCCALLUS County Lookup by Coordinates APIDosvak LLC

From the blog

Reads that touch this API.

Timezones Dictionary API: Global Timezone Data and Best Alternatives for 2026Jul 9, 2026Web Data Extraction: Use Cases and ApproachesJul 9, 2026Mastering Axios GET Params: Efficient API Calls with Real-World ApplicationsSep 10, 2026Why Manual Scraping SERP Data Is Dead: The Rise of Reliable SERP APIs in 2026Aug 5, 2026