---
type: "firecrawl-provider"
description: "Earthquake search and event detail from the USGS ANSS Comprehensive Earthquake Catalog (ComCat) via its public FDSN event web service: worldwide events with US coverage down to small magnitudes, PAGER alerts, ShakeMap intensities and Did You Feel It? reports. Public-domain US government data."
use_when: "Earthquake search and event detail from the USGS ANSS Comprehensive Earthquake Catalog (ComCat) via its public FDSN event web service: worldwide events with US coverage down to small magnitudes, PAGER alerts, ShakeMap intensities and Did You Feel It? reports. Public-domain US government data."
categories: "Public records"
capabilities: 2
credits_per_call: 5
---
# USGS Earthquake Catalog (ComCat) on Firecrawl Alexandria

Earthquake search and event detail from the USGS ANSS Comprehensive Earthquake Catalog (ComCat) via its public FDSN event web service: worldwide events with US coverage down to small magnitudes, PAGER alerts, ShakeMap intensities and Did You Feel It? reports. Public-domain US government data.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `earthquake-usgs-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/earthquake-usgs-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/earthquake-usgs-gov/openapi.json)

## Capabilities

- [Event](https://firecrawl.dev/alexandria/agents/providers/earthquake-usgs-gov/earthquakes/event): One ComCat event by id (or event page URL) from /fdsnws/event/1/query?eventid=..., with the normalized event record plus curated summaries of its preferred ShakeMap (maximum estimated intensity, version, review status), PAGER (overall alert level, fatality and economic alert levels from the PAGER alerts.json, which of them set the overall alert) and Did You Feel It? (maximum reported intensity, response count) products. Each summary is null when the event has no such product. Any associated id (e.g. usp000hvnu) resolves to the preferred event.
- [Search](https://firecrawl.dev/alexandria/agents/providers/earthquake-usgs-gov/earthquakes/search): Search the USGS ComCat earthquake catalog through the FDSN event web service (/fdsnws/event/1/query, GeoJSON) by origin-time window, magnitude and depth ranges, a latitude/longitude rectangle or a point plus radius, PAGER alert level and event type. Returns normalized events (ISO-8601 UTC times, latitude/longitude/depth_km, preferred magnitude and type, place, PAGER alert, tsunami flag, DYFI felt reports and intensities, significance, review status, event page URL). Pages with cursor/next_cursor (FDSN offset). Without start_time USGS searches the last 30 days; without end_time it searches up to now.

## 1. Choose this provider when

Earthquake search and event detail from the USGS ANSS Comprehensive Earthquake Catalog (ComCat) via its public FDSN event web service: worldwide events with US coverage down to small magnitudes, PAGER alerts, ShakeMap intensities and Did You Feel It? reports. Public-domain US government data.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "earthquake-usgs-gov",
  "capability": "earthquakes/event",
  "options": {
    "id": "us6000jllz"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `id` (string): ComCat event id such as us6000jllz or official20110311054624120_30 (case-insensitive). Pass id or url, not both. Pattern: ^[A-Za-z0-9_-]{2,64}$. Example: `<id>`
- `url` (string): USGS event page URL, https://earthquake.usgs.gov/earthquakes/eventpage/<id>[/...]. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "earthquake-usgs-gov",
    capability: "earthquakes/event",
    options: {
      id: "us6000jllz",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "earthquake-usgs-gov",
  "capability": "earthquakes/event",
  "options": {
    "id": "us6000jllz"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "earthquake-usgs-gov",
    "capability": "earthquakes/event",
    "options": {
      "id": "us6000jllz"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'earthquake-usgs-gov/earthquakes/event' \
  --options '{"id":"us6000jllz"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "earthquake-usgs-gov",
  "capability": "earthquakes/event",
  "options": {
    "id": "us6000jllz"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "earthquake-usgs-gov",
  "capability": "earthquakes/event",
  "options": {
    "id": "us6000jllz"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "dyfi": {
    "max_cdi": 9.1,
    "responses": 3182,
    "source": "us",
    "updated": "2026-04-13T23:32:30.032Z"
  },
  "event": {
    "alert": "red",
    "azimuthal_gap_deg": 17,
    "cdi": 9.1,
    "code": "6000jllz",
    "depth_km": 10,
    "event_type": "earthquake",
    "felt": 3182,
    "id": "us6000jllz",
    "ids": [
      "us6000jllz",
      "usauto6000jllz",
      "at00rpmwxe",
      "pt23037000"
    ],
    "latitude": 37.2256,
    "longitude": 37.0143,
    "magnitude": 7.8,
    "magnitude_type": "mww",
    "min_distance_deg": 0.165,
    "mmi": 9.537,
    "network": "us",
    "place": "Pazarcik earthquake, Kahramanmaras earthquake sequence",
    "product_types": [
      "dyfi",
      "earthquake-name",
      "finite-fault",
      "general-link",
      "general-text",
      "ground-failure",
      "groundmotion-packet",
      "impact-text",
      "internal-moment-tensor",
      "internal-origin",
      "losspager",
      "moment-tensor",
      "origin",
      "phase-data",
      "shakemap"
    ],
    "rms_s": 0.66,
    "significance": 2910,
    "sources": [
      "us",
      "usauto",
      "at",
      "pt"
    ],
    "stations": 266,
    "status": "reviewed",
    "time": "2023-02-06T01:17:34.342Z",
    "title": "M 7.8 - Pazarcik earthquake, Kahramanmaras earthquake sequence",
    "tsunami": false,
    "updated": "2026-04-13T23:32:30.032Z",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000jllz"
  },
  "pager": {
    "alert_level": "red",
    "economic_alert": "red",
    "fatality_alert": "red",
    "max_mmi": 9,
    "review_status": "automatic",
    "source": "us",
    "summary_alert": "economic",
    "updated": "2023-04-14T18:13:56.124Z"
  },
  "shakemap": {
    "map_status": "automatic",
    "max_mmi": 9.537,
    "review_status": "automatic",
    "source": "us",
    "updated": "2025-09-03T17:52:20.993Z",
    "version": "19"
  },
  "source_url": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us6000jllz&format=geojson"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Event

- Capability: `earthquakes/event`
- Description: One ComCat event by id (or event page URL) from /fdsnws/event/1/query?eventid=..., with the normalized event record plus curated summaries of its preferred ShakeMap (maximum estimated intensity, version, review status), PAGER (overall alert level, fatality and economic alert levels from the PAGER alerts.json, which of them set the overall alert) and Did You Feel It? (maximum reported intensity, response count) products. Each summary is null when the event has no such product. Any associated id (e.g. usp000hvnu) resolves to the preferred event.
- Instructions: Look up one known earthquake's authoritative parameters and impact estimates: how strong the shaking was, the PAGER alert and whether fatalities or economic losses drove it, how many people reported feeling it. Use search to find event ids.
- Cost: 5 credits per call
- Capability file: [Event](https://firecrawl.dev/alexandria/agents/providers/earthquake-usgs-gov/earthquakes/event)

Accepted options:
- `id` (string): ComCat event id such as us6000jllz or official20110311054624120_30 (case-insensitive). Pass id or url, not both. Pattern: ^[A-Za-z0-9_-]{2,64}$. Example: `<id>`
- `url` (string): USGS event page URL, https://earthquake.usgs.gov/earthquakes/eventpage/<id>[/...]. Example: `<url>`

Response schema example:
```json
{
  "dyfi": {
    "max_cdi": 9.1,
    "responses": 3182,
    "source": "us",
    "updated": "2026-04-13T23:32:30.032Z"
  },
  "event": {
    "alert": "red",
    "azimuthal_gap_deg": 17,
    "cdi": 9.1,
    "code": "6000jllz",
    "depth_km": 10,
    "event_type": "earthquake",
    "felt": 3182,
    "id": "us6000jllz",
    "ids": [
      "us6000jllz",
      "usauto6000jllz",
      "at00rpmwxe",
      "pt23037000"
    ],
    "latitude": 37.2256,
    "longitude": 37.0143,
    "magnitude": 7.8,
    "magnitude_type": "mww",
    "min_distance_deg": 0.165,
    "mmi": 9.537,
    "network": "us",
    "place": "Pazarcik earthquake, Kahramanmaras earthquake sequence",
    "product_types": [
      "dyfi",
      "earthquake-name",
      "finite-fault",
      "general-link",
      "general-text",
      "ground-failure",
      "groundmotion-packet",
      "impact-text",
      "internal-moment-tensor",
      "internal-origin",
      "losspager",
      "moment-tensor",
      "origin",
      "phase-data",
      "shakemap"
    ],
    "rms_s": 0.66,
    "significance": 2910,
    "sources": [
      "us",
      "usauto",
      "at",
      "pt"
    ],
    "stations": 266,
    "status": "reviewed",
    "time": "2023-02-06T01:17:34.342Z",
    "title": "M 7.8 - Pazarcik earthquake, Kahramanmaras earthquake sequence",
    "tsunami": false,
    "updated": "2026-04-13T23:32:30.032Z",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000jllz"
  },
  "pager": {
    "alert_level": "red",
    "economic_alert": "red",
    "fatality_alert": "red",
    "max_mmi": 9,
    "review_status": "automatic",
    "source": "us",
    "summary_alert": "economic",
    "updated": "2023-04-14T18:13:56.124Z"
  },
  "shakemap": {
    "map_status": "automatic",
    "max_mmi": 9.537,
    "review_status": "automatic",
    "source": "us",
    "updated": "2025-09-03T17:52:20.993Z",
    "version": "19"
  },
  "source_url": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us6000jllz&format=geojson"
}
```

### Search

- Capability: `earthquakes/search`
- Description: Search the USGS ComCat earthquake catalog through the FDSN event web service (/fdsnws/event/1/query, GeoJSON) by origin-time window, magnitude and depth ranges, a latitude/longitude rectangle or a point plus radius, PAGER alert level and event type. Returns normalized events (ISO-8601 UTC times, latitude/longitude/depth_km, preferred magnitude and type, place, PAGER alert, tsunami flag, DYFI felt reports and intensities, significance, review status, event page URL). Pages with cursor/next_cursor (FDSN offset). Without start_time USGS searches the last 30 days; without end_time it searches up to now.
- Instructions: Find earthquakes (or other seismic events) in a time window, region or magnitude range: recent significant quakes, a historical sequence, quakes near a site. Use event for one event's ShakeMap, PAGER and DYFI summaries.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/earthquake-usgs-gov/earthquakes/search)

Accepted options:
- `alert_level` (string): Only events with this PAGER alert level. Example: `green`
- `cursor` (string): next_cursor from the previous page of the same search. Pattern: ^[0-9]{1,5}$. Example: `<cursor>`
- `end_time` (string): Latest origin time (inclusive), UTC, same formats. A bare date means 00:00:00 of that day. Defaults to now. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}(:[0-9]{2}(\.[0-9]{1,3})?)?)?Z?$. Example: `<end_time>`
- `event_type` (string): ComCat event type, e.g. earthquake, explosion, quarry blast. Defaults to every type. Pattern: ^[a-z][a-z ]{0,39}$. Example: `<event_type>`
- `latitude` (number): Circle center latitude; requires longitude and max_radius_km. Example: `10`
- `limit` (number): Events per page. Example: `50`
- `longitude` (number): Circle center longitude. Example: `10`
- `max_depth_km` (number): max_depth_km Example: `10`
- `max_latitude` (number): Rectangle north edge. Example: `10`
- `max_longitude` (number): Rectangle east edge. Example: `10`
- `max_magnitude` (number): max_magnitude Example: `10`
- `max_radius_km` (number): Circle radius in kilometres. Example: `10`
- `min_depth_km` (number): min_depth_km Example: `10`
- `min_latitude` (number): Rectangle south edge. Rectangle edges may be given in any subset; do not combine with the circle. Example: `10`
- `min_longitude` (number): Rectangle west edge; values beyond +/-180 let a rectangle cross the antimeridian. Example: `10`
- `min_magnitude` (number): min_magnitude Example: `10`
- `order_by` (string): Newest first (time), oldest first, largest first (magnitude) or smallest first. Example: `time`
- `start_time` (string): Earliest origin time, UTC: YYYY-MM-DD or YYYY-MM-DDTHH:MM[:SS[.fff]][Z]. Defaults to 30 days ago. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}(:[0-9]{2}(\.[0-9]{1,3})?)?)?Z?$. Example: `<start_time>`

Response schema example:
```json
{
  "count": 3,
  "events": [
    {
      "alert": null,
      "azimuthal_gap_deg": 9.5,
      "cdi": 9.1,
      "code": "20110311054624120_30",
      "depth_km": 29,
      "event_type": "earthquake",
      "felt": 1459,
      "id": "official20110311054624120_30",
      "ids": [
        "usc0001xgp",
        "official20110311054624120_30",
        "usp000hvnu",
        "choy20110311054623",
        "duputel201103110546a",
        "atlas20110311054624",
        "iscgem16461282"
      ],
      "latitude": 38.297,
      "longitude": 142.373,
      "magnitude": 9.1,
      "magnitude_type": "mww",
      "min_distance_deg": null,
      "mmi": 8.18,
      "network": "official",
      "place": "2011 Great Tohoku Earthquake, Japan",
      "product_types": [
        "dyfi",
        "finite-fault",
        "focal-mechanism",
        "general-header",
        "general-link",
        "general-text",
        "ground-failure",
        "impact-text",
        "moment-tensor",
        "origin",
        "phase-data",
        "poster",
        "scitech-link",
        "scitech-text",
        "shakemap",
        "trump-impact-text",
        "trump-origin",
        "trump-phase-data",
        "trump-shakemap"
      ],
      "rms_s": 1.16,
      "significance": 2184,
      "sources": [
        "us",
        "official",
        "choy",
        "duputel",
        "atlas",
        "iscgem"
      ],
      "stations": 541,
      "status": "reviewed",
      "time": "2011-03-11T05:46:24.120Z",
      "title": "M 9.1 - 2011 Great Tohoku Earthquake, Japan",
      "tsunami": false,
      "updated": "2026-09-25T23:08:42.510Z",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/official20110311054624120_30"
    },
    {
      "alert": null,
      "azimuthal_gap_deg": 48.4,
      "cdi": 7.6,
      "code": "p000hvpa",
      "depth_km": 42.6,
      "event_type": "earthquake",
      "felt": 256,
      "id": "usp000hvpa",
      "ids": [
        "usc0001xhz",
        "usp000hvpa",
        "atlas20110311061540",
        "iscgem602707261"
      ],
      "latitude": 36.281,
      "longitude": 141.111,
      "magnitude": 7.9,
      "magnitude_type": "mwc",
      "min_distance_deg": null,
      "mmi": 6.705,
      "network": "us",
      "place": "47 km E of ?arai, Japan",
      "product_types": [
        "associate",
        "dyfi",
        "general-text",
        "impact-text",
        "moment-tensor",
        "origin",
        "phase-data",
        "poster",
        "shakemap",
        "trump-shakemap"
      ],
      "rms_s": 1.44,
      "significance": 1155,
      "sources": [
        "us",
        "atlas",
        "iscgem"
      ],
      "stations": 163,
      "status": "reviewed",
      "time": "2011-03-11T06:15:40.280Z",
      "title": "M 7.9 - 47 km E of ?arai, Japan",
      "tsunami": false,
      "updated": "2023-06-14T18:07:38.583Z",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpa"
    },
    {
      "alert": null,
      "azimuthal_gap_deg": 10.8,
      "cdi": 6.8,
      "code": "p000hvpg",
      "depth_km": 18.6,
      "event_type": "earthquake",
      "felt": 28,
      "id": "usp000hvpg",
      "ids": [
        "usc0001xig",
        "usp000hvpg",
        "iscgem16304073"
      ],
      "latitude": 38.058,
      "longitude": 144.59,
      "magnitude": 7.7,
      "magnitude_type": "mwc",
      "min_distance_deg": null,
      "mmi": 4.081,
      "network": "us",
      "place": "272 km ESE of Kamaishi, Japan",
      "product_types": [
        "associate",
        "dyfi",
        "general-text",
        "impact-text",
        "moment-tensor",
        "origin",
        "phase-data",
        "poster",
        "shakemap"
      ],
      "rms_s": 0.85,
      "significance": 931,
      "sources": [
        "us",
        "iscgem"
      ],
      "stations": 507,
      "status": "reviewed",
      "time": "2011-03-11T06:25:50.300Z",
      "title": "M 7.7 - 272 km ESE of Kamaishi, Japan",
      "tsunami": false,
      "updated": "2022-07-19T08:04:51.126Z",
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/usp000hvpg"
    }
  ],
  "next_cursor": null,
  "source_url": "https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&starttime=2011-03-11T00:00:00.000Z&endtime=2011-03-12T00:00:00.000Z&minmagnitude=7&orderby=magnitude&limit=6&offset=1"
}
```