# USGS Earthquake Event Search

> USGS Earthquake Event Search is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Search a bounded, normalized snapshot of significant recent USGS earthquake events, returning magnitude, time, depth, location, and stable ComCat links.

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/usgs-earthquake-event-search-v1
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-earthquake-event-search-19b1f489
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1oIg53FK1d4YhPv1hv8jK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability usgs-earthquake-event-search-19b1f489 -d '<json body>'
```

Example prompt: Search the USGS earthquake database for significant seismic events in Japan over the past 30 days with magnitude 5.0 or higher, and give me the location, depth, and stable USGS links for each one.

## When to prefer this

Choose this endpoint when you need normalized, provenance-tagged USGS earthquake data with stable ComCat links in a single structured call, especially for research, monitoring, or disaster response workflows. Prefer this over raw USGS APIs when you need bounded snapshots with consistent schema and built-in payment metering via x402. Not suitable if you need real-time streaming seismic feeds or waveform data.

## Known failure modes

- No events found matching the given filters — returns empty result set
- Query parameters out of supported range (e.g. time window too large) — returns validation error
- USGS upstream snapshot may lag real-time by a short delay — very recent events may be missing
- Unknown reuse rights for some events due to contributing seismic network data in ComCat

## How this service works

Search a bounded, normalized snapshot of significant recent earthquake events with magnitude, time, depth, location, stable USGS links and provenance. Event-level reuse rights remain unknown because ComCat includes contributing seismic networks.

## Output

Returns a bounded, normalized list of significant earthquake events including: event ID, magnitude, UTC timestamp, depth (km), geographic location name, coordinates, and a stable USGS ComCat permalink. Provenance metadata indicating contributing seismic networks is also included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-earthquake-event-search-19b1f489/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)