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
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.
| Field | Type | Description |
|---|---|---|
idkey | string | USGS preferred event identifier. Merged events may receive a different preferred identifier. |
title | string, nullable | Publisher title describing magnitude and location. |
magnitude | number, nullable | Publisher magnitude estimate; nullable and subject to revision. |
place | string, nullable | Publisher description of the event location. |
event_time_ms | integer | Event origin time as milliseconds since the Unix epoch in UTC. |
updated_time_ms | integer | Publisher revision timestamp as milliseconds since the Unix epoch in UTC. |
status | string, nullable | Publisher review status, such as automatic or reviewed. |
event_type | string, nullable | Publisher event type; the feed may include non-earthquake seismic events. |
longitude | number, nullable | Longitude in degrees from the publisher point geometry; nullable. |
latitude | number, nullable | Latitude in degrees from the publisher point geometry; nullable. |
depth_km | number, nullable | Publisher depth estimate in kilometres; nullable and subject to revision. |
url | url | USGS 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.
| Field | Record 1 | Record 2 | Record 3 | Record 4 | Record 5 |
|---|---|---|---|---|---|
id | ci41344007 | us6000tzvn | us6000tzva | us6000tzv6 | aka2026ttygip |
title | M 3.2 - 5 km ESE of Wofford Heights, CA | M 4.9 - 55 km ESE of Kokopo, Papua New Guinea | M 4.5 - 60 km WNW of Colchani, Bolivia | M 4.7 - 36 km WNW of Ollagüe, Chile | M 3.1 - 62 km ENE of Denali Park, Alaska |
magnitude | 3.21411925976672 | 4.9 | 4.5 | 4.7 | 3.1 |
place | 5 km ESE of Wofford Heights, CA | 55 km ESE of Kokopo, Papua New Guinea | 60 km WNW of Colchani, Bolivia | 36 km WNW of Ollagüe, Chile | 62 km ENE of Denali Park, Alaska |
event_time_ms | 1791279476970 | 1791276326946 | 1791269650618 | 1791267393173 | 1791266690916 |
updated_time_ms | 1791279608683 | 1791277967040 | 1791272062040 | 1791268566040 | 1791267561040 |
status | automatic | reviewed | reviewed | reviewed | automatic |
event_type | earthquake | earthquake | earthquake | earthquake | earthquake |
longitude | -118.412002563477 | 152.7519 | -67.4214 | -68.6026 | -147.67 |
latitude | 35.6856651306152 | -4.4773 | -20.0088 | -21.1586 | 63.857 |
depth_km | 3.72000002861023 | 20.643 | 191.741 | 122.011 | 1.3 |
url | https://earthquake.usgs.gov/earthquakes/eventpage/ci41344007 | https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzvn | https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzva | https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzv6 | https://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_IDTypeScript 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.
Related sources
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.