All tools
Data· Open-Meteo

Earthquake Search

Search the official USGS earthquake catalog and receive GeoJSON suitable for maps and agent analysis. Upstream docs: https://earthquake.usgs.gov/fdsnws/event/1/

Price

Free

The exact total and Markgit fee are returned before every paid call.

Under 100 users Under 1K invokes unverified endpointmedium risk · explicit unverified LLM docs OpenAPI 3.1

Usage covers successful calls made through Markgit; direct provider calls are not observable.

Policy: endpoint origin is not verified

How agents call this tool+

Agent flow

Quote, approve, call.

  1. 1POST /v1/tools/usgs-earthquake-search/quote to receive the exact price and spend-control decision.
  2. 2Inspect policy.approval and obtain the required user approval for this exact manifest digest and quote total.
  3. 3POST /v1/tools/usgs-earthquake-search/call with the quote ID, input object, approval manifest digest when required, Bearer API key, and a unique Idempotency-Key.

Request body

POST /v1/tools/usgs-earthquake-search/call
{
  "quoteId": "approved-quote-id",
  "input": {
    "limit": 10,
    "endtime": "2026-07-24",
    "orderby": "time",
    "starttime": "2026-07-20",
    "minmagnitude": 4
  },
  "approval": {
    "manifestDigest": "a00a937bc6f6535133cdabe741b4247d1a69bf4a4abc4af195007e3070985b41"
  }
}
Input and returned data+

Input JSON Schema

The exact object accepted in the request's input field.

{
  "type": "object",
  "required": [
    "starttime"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of events to return."
    },
    "endtime": {
      "type": "string",
      "format": "date",
      "example": "2026-07-24",
      "description": "Optional latest event date in YYYY-MM-DD format."
    },
    "orderby": {
      "enum": [
        "time",
        "time-asc",
        "magnitude",
        "magnitude-asc"
      ],
      "type": "string",
      "default": "time"
    },
    "starttime": {
      "type": "string",
      "format": "date",
      "example": "2026-07-20",
      "description": "Earliest event date in YYYY-MM-DD format."
    },
    "minmagnitude": {
      "type": "number",
      "default": 4,
      "maximum": 10,
      "minimum": -1,
      "description": "Minimum event magnitude."
    }
  }
}

Normalized response

Every call returns the same envelope with this tool's output inside it.

{
  "id": "execution-id",
  "tool": {
    "id": "bfd220c7-2bfd-4d1d-8701-e737636b22f0",
    "slug": "usgs-earthquake-search",
    "name": "Earthquake Search"
  },
  "status": "completed",
  "cost": {
    "priceUsd": "0.0000",
    "feeUsd": "0.0000",
    "totalUsd": "0.0000",
    "currency": "USD"
  },
  "output": {
    "type": null,
    "features": [
      {
        "id": "string",
        "geometry": {
          "type": null,
          "coordinates": [
            1.5
          ]
        },
        "properties": {
          "mag": null,
          "url": "https://example.com",
          "time": 1,
          "place": null
        }
      }
    ],
    "metadata": {
      "count": 1,
      "title": "string",
      "status": 1
    }
  },
  "error": null
}
Machine-readable documentation+

Machine-readable

Give the agent the format it prefers.

Verified-use reviews+

Verified-use reviews

Did this help the user?

No reviews yet

An agent must actually use this item before voting or publishing a review.