SourceFinch Verified · Disasters & emergency management

USGS significant seismic events — past month

Monitor USGS seismic events in the past month, with preferred event identifiers, magnitude, publisher timestamps, review status and coordinates. Retain evidence of later publisher revisions.

  • Healthy · 100% of observed runs successful
  • Global seismic observations
  • Publisher's public API
  • 12 typed fields

Monitor this sourceAPI, CLI, SDK and MCP

At a glance

Publisher
U.S. Geological Survey
Jurisdiction
Global seismic observations
Publisher updates
USGS summary feed updated every minute; monitor hourly
SourceFinch checks
Hourly by default
Records per run
6 in the latest run
Record key
id
Acquired from
Publisher's public API: https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/significant_month.geojson
Recipe
v1.0.0, approved October 6, 2026
Verified since
October 6, 2026
Last green run
October 6, 2026

What the data contains

Reads the complete USGS significant_month.geojson rolling summary feed for the past month. Each feature becomes a record keyed by the publisher preferred event identifier. Magnitudes, locations, review status and timestamps can change as USGS revises its estimates. An event leaving this rolling window does not prove deletion, resolution or that the hazard has ended. Preferred identifiers can also change when events are merged; this recipe does not resolve aliases across identifiers. This recipe retains all feed event types. It does not infer impacts on infrastructure, resolve event aliases, or issue safety advice. Empty feeds are a possible publisher state; inspect source health before interpreting an empty result. SourceFinch is independent of USGS.

Fields and types

Every record has these fields. The key field id identifies a record across runs, so changes are reported field by field.

FieldTypeDescription
idkeystringUSGS preferred event identifier. Merged events may receive a different preferred identifier.
titlestring, nullablePublisher title describing magnitude and location.
magnitudenumber, nullablePublisher magnitude estimate; nullable and subject to revision.
placestring, nullablePublisher description of the event location.
event_time_msintegerEvent origin time as milliseconds since the Unix epoch in UTC.
updated_time_msintegerPublisher revision timestamp as milliseconds since the Unix epoch in UTC.
statusstring, nullablePublisher review status, such as automatic or reviewed.
event_typestring, nullablePublisher event type; the feed may include non-earthquake seismic events.
longitudenumber, nullableLongitude in degrees from the publisher point geometry; nullable.
latitudenumber, nullableLatitude in degrees from the publisher point geometry; nullable.
depth_kmnumber, nullablePublisher depth estimate in kilometres; nullable and subject to revision.
urlurlUSGS detail page for the event.

Sample output

The first 5 of 6 records from SourceFinch's own run on October 6, 2026, exactly as delivered.

FieldRecord 1Record 2Record 3Record 4Record 5
idus6000tz1yuw714111952us6000txpius7000tiqcus7000ti1p
titleM 4.7 - 5 km NNE of Korumburra, AustraliaM 4.2 - 6 km WNW of Wauna, WashingtonM 6.6 - 80 km ENE of Tadine, New CaledoniaM 6.4 - 49 km NNE of Kainantu, Papua New GuineaM 6.5 - 177 km W of Nikolski, Alaska
magnitude4.74.156.66.46.5
place5 km NNE of Korumburra, Australia6 km WNW of Wauna, Washington80 km ENE of Tadine, New Caledonia49 km NNE of Kainantu, Papua New Guinea177 km W of Nikolski, Alaska
event_time_ms17909568995811790715956370179037138330917898958556241789654792472
updated_time_ms17909711520741791279690533179045820782617899827255301791037797047
statusreviewedreviewedreviewedreviewedreviewed
event_typeearthquakeearthquakeearthquakeearthquakeearthquake
longitude145.8401-122.722168.61146.0922-171.5033
latitude-38.380247.4003333333333-21.2982-5.902152.9564
depth_km1027.9210104.32998
urlhttps://earthquake.usgs.gov/earthquakes/eventpage/us6000tz1yhttps://earthquake.usgs.gov/earthquakes/eventpage/uw714111952https://earthquake.usgs.gov/earthquakes/eventpage/us6000txpihttps://earthquake.usgs.gov/earthquakes/eventpage/us7000tiqchttps://earthquake.usgs.gov/earthquakes/eventpage/us7000ti1p
Sample as JSON
[
  {
    "id": "us6000tz1y",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tz1y",
    "place": "5 km NNE of Korumburra, Australia",
    "title": "M 4.7 - 5 km NNE of Korumburra, Australia",
    "status": "reviewed",
    "depth_km": 10,
    "latitude": -38.3802,
    "longitude": 145.8401,
    "magnitude": 4.7,
    "event_type": "earthquake",
    "event_time_ms": 1790956899581,
    "updated_time_ms": 1790971152074
  },
  {
    "id": "uw714111952",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/uw714111952",
    "place": "6 km WNW of Wauna, Washington",
    "title": "M 4.2 - 6 km WNW of Wauna, Washington",
    "status": "reviewed",
    "depth_km": 27.92,
    "latitude": 47.4003333333333,
    "longitude": -122.722,
    "magnitude": 4.15,
    "event_type": "earthquake",
    "event_time_ms": 1790715956370,
    "updated_time_ms": 1791279690533
  },
  {
    "id": "us6000txpi",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000txpi",
    "place": "80 km ENE of Tadine, New Caledonia",
    "title": "M 6.6 - 80 km ENE of Tadine, New Caledonia",
    "status": "reviewed",
    "depth_km": 10,
    "latitude": -21.2982,
    "longitude": 168.61,
    "magnitude": 6.6,
    "event_type": "earthquake",
    "event_time_ms": 1790371383309,
    "updated_time_ms": 1790458207826
  },
  {
    "id": "us7000tiqc",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000tiqc",
    "place": "49 km NNE of Kainantu, Papua New Guinea",
    "title": "M 6.4 - 49 km NNE of Kainantu, Papua New Guinea",
    "status": "reviewed",
    "depth_km": 104.329,
    "latitude": -5.9021,
    "longitude": 146.0922,
    "magnitude": 6.4,
    "event_type": "earthquake",
    "event_time_ms": 1789895855624,
    "updated_time_ms": 1789982725530
  },
  {
    "id": "us7000ti1p",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000ti1p",
    "place": "177 km W of Nikolski, Alaska",
    "title": "M 6.5 - 177 km W of Nikolski, Alaska",
    "status": "reviewed",
    "depth_km": 98,
    "latitude": 52.9564,
    "longitude": -171.5033,
    "magnitude": 6.5,
    "event_type": "earthquake",
    "event_time_ms": 1789654792472,
    "updated_time_ms": 1791037797047
  }
]

Evidence behind every value

  • Each run keeps the publisher's exact response, hashed with SHA-256. This sample came from a response with hash 8b295e621638b22853700045a9d5f2592018260ca79416ad707327094f074150.
  • Every value records where it came from in that response: a JSON Pointer into the retained capture.
  • Each run gets a signed manifest (Ed25519) timestamped by an RFC 3161 authority: this run's manifest hash is 2d74e63c664cfc37f78519d8bd0e58269f33f763f0e0f1ecec8cb657a88c3b0e, timestamped October 6, 2026.
  • The compliance state at capture is recorded with the evidence: robots.txt hash and verdict, AI-preference signals, crawler identity and the usage rights below.
  • Download any run as an evidence bundle (WACZ) and check it offline, without trusting SourceFinch: sourcefinch verify-bundle run.wacz.

Terms posture and usage rights

Terms
Automated access permitted · publisher's terms
robots.txt
None published (HTTP 404); access allowed under RFC 9309
AI-preference signals
None observed at review
Public record
Yes. USGS public-domain data policy for USGS-authored data.
Reviewed
October 6, 2026; next review April 6, 2027
Licence basis
U.S. government work (public domain)
Commercial use
Allowed
Redistribution
Allowed
Attribution
Required (text below)

USGS-authored data and information are in the U.S. public domain. Credit the U.S. Geological Survey. Third-party copyrighted materials, personnel likenesses and trademarked identifiers have separate restrictions; this recipe extracts seismic data only and excludes logos, images and multimedia.

U.S. Geological Survey. This product is independent of and is not endorsed by USGS.

Usage rights travel with every record SourceFinch delivers (API, exports, webhooks and evidence bundles). They are our documented understanding of the publisher's stated terms, not legal advice.

Reliability

Runs, last 30 days
2
Green
100%
Failed
0
Median run time
0.5 s
Latest run
success, October 6, 2026

Measured on completed runs of this recipe version across SourceFinch, anonymized, within a rolling 30-day window. First successful observation: October 6, 2026. A new recipe has only the history collected since that date; this is not a 30-day uptime guarantee.

Use it

Every surface creates the same monitor from this Verified recipe. Monitors keep record history, report field-level changes and deliver by webhook, export or email. You confirm you have the right to collect the source (rights: true).

Console

Open this recipe in the console: it preserves the reviewed URL, fields and record key. Review the latest captured sample, confirm source rights, and choose a schedule before creating your monitor.

source.json

The request body used by the API, CLI and SDK examples.

{
  "name": "USGS significant seismic events — past month",
  "url": "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/significant_month.geojson",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "features[*]",
    "fields": {
      "id": "id",
      "url": "properties.url",
      "place": "properties.place",
      "title": "properties.title",
      "status": "properties.status",
      "depth_km": "geometry.coordinates[2]",
      "latitude": "geometry.coordinates[1]",
      "longitude": "geometry.coordinates[0]",
      "magnitude": "properties.mag",
      "event_type": "properties.type",
      "event_time_ms": "properties.time",
      "updated_time_ms": "properties.updated"
    },
    "required": [
      "id",
      "event_time_ms",
      "updated_time_ms",
      "url"
    ],
    "types": {
      "depth_km": "number",
      "latitude": "number",
      "longitude": "number",
      "magnitude": "number",
      "event_time_ms": "integer",
      "updated_time_ms": "integer"
    }
  },
  "key_field": "id",
  "schedule": "hourly",
  "rights": true,
  "catalog": {
    "slug": "usgs-significant-earthquakes-month",
    "version_id": "b387db49-c9ea-4a24-b776-116a73c5afb1"
  }
}

REST API

Create an API key under Console → API keys. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/usgs-significant-earthquakes-month -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

CLI

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get usgs-significant-earthquakes-month --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

TypeScript SDK

The SDK is not on npm yet; see /docs/sdk.

import { SourceFinch } from "@sourcefinch/sdk";

const sf = new SourceFinch({ apiKey: process.env.SOURCEFINCH_API_KEY });
const entry = await sf.catalog.get("usgs-significant-earthquakes-month");
const source = await sf.sources.create({
  catalog: { slug: entry.slug, version_id: entry.recipe.version_id },
  name: entry.name.slice(0, 100),
  url: entry.acquisition_path.endpoint,
  recipe: entry.recipe.definition,
  key_field: entry.recipe.key_field,
  schedule: entry.recipe.schedule,
  rights: true, // you confirm you have the right to collect this source
});
const run = await sf.runs.wait((await sf.runs.create(source.id)).id);
console.log(run.status);

MCP

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor USGS significant seismic events — past month: get_catalog_source usgs-significant-earthquakes-month,
then create_source with its create_source_args (dry run first), then run_source."

Pricing

Each check is one run, whatever the number of records, and failed runs are free. On its default hourly schedule this source uses about 720 runs a month. It uses HTTP acquisition, so no browser runs are needed. See plans.

SourceFinch is independent and is not affiliated with or endorsed by U.S. Geological Survey. This page describes usgs significant seismic events — past month as SourceFinch acquires it.