SourceFinch Verified · Disasters & emergency management

USGS magnitude 2.5+ seismic events — past day

Monitor USGS seismic events in the past day, 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
42 in the latest run
Record key
id
Acquired from
Publisher's public API: https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_day.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 2.5_day.geojson rolling summary feed for the past day. 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 42 records from SourceFinch's own run on October 6, 2026, exactly as delivered.

FieldRecord 1Record 2Record 3Record 4Record 5
idci41344007us6000tzvnus6000tzvaus6000tzv6aka2026ttygip
titleM 3.2 - 5 km ESE of Wofford Heights, CAM 4.9 - 55 km ESE of Kokopo, Papua New GuineaM 4.5 - 60 km WNW of Colchani, BoliviaM 4.7 - 36 km WNW of Ollagüe, ChileM 3.1 - 62 km ENE of Denali Park, Alaska
magnitude3.214119259766724.94.54.73.1
place5 km ESE of Wofford Heights, CA55 km ESE of Kokopo, Papua New Guinea60 km WNW of Colchani, Bolivia36 km WNW of Ollagüe, Chile62 km ENE of Denali Park, Alaska
event_time_ms17912794769701791276326946179126965061817912673931731791266690916
updated_time_ms17912796086831791277967040179127206204017912685660401791267561040
statusautomaticreviewedreviewedreviewedautomatic
event_typeearthquakeearthquakeearthquakeearthquakeearthquake
longitude-118.412002563477152.7519-67.4214-68.6026-147.67
latitude35.6856651306152-4.4773-20.0088-21.158663.857
depth_km3.7200000286102320.643191.741122.0111.3
urlhttps://earthquake.usgs.gov/earthquakes/eventpage/ci41344007https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzvnhttps://earthquake.usgs.gov/earthquakes/eventpage/us6000tzvahttps://earthquake.usgs.gov/earthquakes/eventpage/us6000tzv6https://earthquake.usgs.gov/earthquakes/eventpage/aka2026ttygip
Sample as JSON
[
  {
    "id": "ci41344007",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/ci41344007",
    "place": "5 km ESE of Wofford Heights, CA",
    "title": "M 3.2 - 5 km ESE of Wofford Heights, CA",
    "status": "automatic",
    "depth_km": 3.72000002861023,
    "latitude": 35.6856651306152,
    "longitude": -118.412002563477,
    "magnitude": 3.21411925976672,
    "event_type": "earthquake",
    "event_time_ms": 1791279476970,
    "updated_time_ms": 1791279608683
  },
  {
    "id": "us6000tzvn",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzvn",
    "place": "55 km ESE of Kokopo, Papua New Guinea",
    "title": "M 4.9 - 55 km ESE of Kokopo, Papua New Guinea",
    "status": "reviewed",
    "depth_km": 20.643,
    "latitude": -4.4773,
    "longitude": 152.7519,
    "magnitude": 4.9,
    "event_type": "earthquake",
    "event_time_ms": 1791276326946,
    "updated_time_ms": 1791277967040
  },
  {
    "id": "us6000tzva",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzva",
    "place": "60 km WNW of Colchani, Bolivia",
    "title": "M 4.5 - 60 km WNW of Colchani, Bolivia",
    "status": "reviewed",
    "depth_km": 191.741,
    "latitude": -20.0088,
    "longitude": -67.4214,
    "magnitude": 4.5,
    "event_type": "earthquake",
    "event_time_ms": 1791269650618,
    "updated_time_ms": 1791272062040
  },
  {
    "id": "us6000tzv6",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzv6",
    "place": "36 km WNW of Ollagüe, Chile",
    "title": "M 4.7 - 36 km WNW of Ollagüe, Chile",
    "status": "reviewed",
    "depth_km": 122.011,
    "latitude": -21.1586,
    "longitude": -68.6026,
    "magnitude": 4.7,
    "event_type": "earthquake",
    "event_time_ms": 1791267393173,
    "updated_time_ms": 1791268566040
  },
  {
    "id": "aka2026ttygip",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/aka2026ttygip",
    "place": "62 km ENE of Denali Park, Alaska",
    "title": "M 3.1 - 62 km ENE of Denali Park, Alaska",
    "status": "automatic",
    "depth_km": 1.3,
    "latitude": 63.857,
    "longitude": -147.67,
    "magnitude": 3.1,
    "event_type": "earthquake",
    "event_time_ms": 1791266690916,
    "updated_time_ms": 1791267561040
  }
]

Evidence behind every value

  • Each run keeps the publisher's exact response, hashed with SHA-256. This sample came from a response with hash fda599bafa02ddd2cb3885250ec22ec5a4159069b12e1f965e19d943c2d0e46f.
  • 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 10a7264d278e9f677b66cef7c6d2887f45444c77a22cc3acbd94943a239f8949, 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.6 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 magnitude 2.5+ seismic events — past day",
  "url": "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_day.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-earthquakes-m25-day",
    "version_id": "937dc8b2-53ee-44e8-8f63-d66391eaab1e"
  }
}

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-earthquakes-m25-day -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-earthquakes-m25-day --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-earthquakes-m25-day");
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 magnitude 2.5+ seismic events — past day: get_catalog_source usgs-earthquakes-m25-day,
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 magnitude 2.5+ seismic events — past day as SourceFinch acquires it.