count

API: usgs.gov:usgs-earthquake-api
Endpoint: /count
Response format: text/plain
Charset: utf-8
Auth: unknown
Method: GET
Last Status: 200
Latency: 775ms

Description

Returns a plain integer count of earthquake events matching the filter criteria. Use this when you only need the total number of events, not the actual event data. Much faster than querying for events when counting large datasets.

From spec: Returns the count of earthquakes matching specified query parameters without returning full event details.

Usage Tips

- Returns a plain integer, not JSON - Supports all the same filter parameters as /query - Use for efficient counting without downloading event data - Rate limit: Be reasonable with request frequency - Maximum result set is unlimited for counting

Parameters (47)

alertlevel (string, query, optional)

PAGER alert level

Constraints: {'enum': ['green', 'yellow', 'orange', 'red']}

callback (string, query, optional)

JSONP callback function name

Constraints: {'pattern': '^[A-Za-z0-9\\._]+$'}

catalog (string, query, optional)

Limit to events from specified catalog

contributor (string, query, optional)

Limit to events from specified contributor

endtime (string, query, optional)

Limit to events on or before specified time (ISO8601)

eventid (string, query, optional)

Select specific event by ID

eventtype (string, query, optional)

Limit to specific event type

format (string, query, optional, default: quakeml)

Output format

Constraints: {'enum': ['quakeml', 'csv', 'geojson', 'kml', 'text', 'xml']}

includeallmagnitudes (boolean, query, optional, default: False)

Include all magnitudes for event

includeallorigins (boolean, query, optional, default: False)

Include all origins for event

includearrivals (boolean, query, optional, default: False)

Include phase arrivals (NOT IMPLEMENTED)

includedeleted (string, query, optional, default: false)

Include deleted events. Value 'only' returns only deleted

Constraints: {'enum': ['true', 'false', 'only']}

includesuperseded (boolean, query, optional, default: False)

Include superseded products

jsonerror (boolean, query, optional, default: False)

Return JSON on errors

kmlanimated (boolean, query, optional, default: False)

Include timestamp for Google Earth animation

kmlcolorby (string, query, optional, default: age)

Color KML by age or depth

Constraints: {'enum': ['age', 'depth']}

latitude (number, query, optional)

Latitude for radius search

Constraints: {'minimum': -90, 'maximum': 90}

limit (integer, query, optional)

Limit results to specified number (max 20000)

Constraints: {'minimum': 1, 'maximum': 20000}

longitude (number, query, optional)

Longitude for radius search

Constraints: {'minimum': -180, 'maximum': 180}

maxalertlevel (string, query, optional)

Maximum PAGER alert level

Constraints: {'enum': ['green', 'yellow', 'orange', 'red']}

maxcdi (number, query, optional)

Maximum Community Determined Intensity (DYFI)

Constraints: {'minimum': 0, 'maximum': 12}

maxdepth (number, query, optional, default: 1000)

Maximum depth in km

Constraints: {'minimum': -100, 'maximum': 1000}

maxgap (number, query, optional)

Maximum azimuthal gap

Constraints: {'minimum': 0, 'maximum': 360}

maxlatitude (number, query, optional, default: 90)

Maximum latitude (-90 to 90)

Constraints: {'minimum': -90, 'maximum': 90}

maxlongitude (number, query, optional, default: 180)

Maximum longitude (-360 to 360)

Constraints: {'minimum': -360, 'maximum': 360}

maxmagnitude (number, query, optional)

Maximum magnitude

maxmmi (number, query, optional)

Maximum Modified Mercalli Intensity (ShakeMap)

Constraints: {'minimum': 0, 'maximum': 12}

maxradius (number, query, optional, default: 180)

Maximum degrees from point. Mutually exclusive with maxradiuskm

Constraints: {'minimum': 0, 'maximum': 180}

maxradiuskm (number, query, optional, default: 20001.6)

Maximum km from point. Mutually exclusive with maxradius

Constraints: {'minimum': 0, 'maximum': 20001.6}

maxsig (integer, query, optional)

Maximum significance

minalertlevel (string, query, optional)

Minimum PAGER alert level

Constraints: {'enum': ['green', 'yellow', 'orange', 'red']}

mincdi (number, query, optional)

Minimum Community Determined Intensity

mindepth (number, query, optional, default: -100)

Minimum depth in km

Constraints: {'minimum': -100, 'maximum': 1000}

minfelt (integer, query, optional)

Minimum DYFI responses

Constraints: {'minimum': 1}

mingap (number, query, optional)

Minimum azimuthal gap

Constraints: {'minimum': 0, 'maximum': 360}

minlatitude (number, query, optional, default: -90)

Minimum latitude (-90 to 90)

Constraints: {'minimum': -90, 'maximum': 90}

minlongitude (number, query, optional, default: -180)

Minimum longitude (-360 to 360)

Constraints: {'minimum': -360, 'maximum': 360}

minmagnitude (number, query, optional)

Minimum magnitude

minsig (integer, query, optional)

Minimum significance

nodata (integer, query, optional, default: 204)

HTTP code when no data found

Constraints: {'enum': [204, 404]}

offset (integer, query, optional, default: 1)

Return results starting at specified event count

Constraints: {'minimum': 1}

orderby (string, query, optional, default: time)

Order results by time or magnitude

Constraints: {'enum': ['time', 'time-asc', 'magnitude', 'magnitude-asc']}

productcode (string, query, optional)

Return event associated with product code

producttype (string, query, optional)

Limit to events with specific product type

Constraints: {'enum': ['moment-tensor', 'focal-mechanism', 'shakemap', 'losspager', 'dyfi']}

reviewstatus (string, query, optional, default: all)

Filter by review status

Constraints: {'enum': ['automatic', 'reviewed', 'all']}

starttime (string, query, optional)

Limit to events on or after specified time (ISO8601)

updatedafter (string, query, optional)

Limit to events updated after specified time

Examples (3)

Count earthquake events openapi-spec

curl 'https://earthquake.usgs.gov/fdsnws/event/1/count'

import requests

resp = requests.get("https://earthquake.usgs.gov/fdsnws/event/1/count")
data = resp.json()

import zingu_apis

api = zingu_apis.api("usgs-earthquake")
result = api.fetch("count")

for item in result:
    print(item)

const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/count");
const data = await resp.json();

Truncate

Auto Table Raw

Count earthquakes in a specific date range probe-gate

Demonstrates counting all earthquakes recorded in a single day.

curl 'https://earthquake.usgs.gov/fdsnws/event/1/count?starttime=2024-01-01&endtime=2024-01-02'

import requests

resp = requests.get(
    "https://earthquake.usgs.gov/fdsnws/event/1/count",
    params={
        'starttime': '2024-01-01',
        'endtime': '2024-01-02',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("usgs-earthquake")
result = api.fetch("count", starttime="2024-01-01", endtime="2024-01-02")

for item in result:
    print(item)

const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/count?starttime=2024-01-01&endtime=2024-01-02");
const data = await resp.json();

Truncate

Auto Table Raw

Count earthquakes above magnitude 4.0 in a month probe-gate

Demonstrates counting significant earthquakes using magnitude filtering.

curl 'https://earthquake.usgs.gov/fdsnws/event/1/count?minmagnitude=4.0&starttime=2024-01-01&endtime=2024-01-31'

import requests

resp = requests.get(
    "https://earthquake.usgs.gov/fdsnws/event/1/count",
    params={
        'minmagnitude': '4.0',
        'starttime': '2024-01-01',
        'endtime': '2024-01-31',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("usgs-earthquake")
result = api.fetch("count", minmagnitude=4.0, starttime="2024-01-01", endtime="2024-01-31")

for item in result:
    print(item)

const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/count?minmagnitude=4.0&starttime=2024-01-01&endtime=2024-01-31");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 17:03:32.518760	200	775ms
2026-04-16 03:29:10.033412	200	308ms
2026-04-16 03:11:13.956241	200	390ms
2026-04-16 00:41:16.192613	200	578ms
2026-04-15 04:04:01.387570	200	607ms
2026-04-15 02:17:55.581160	200	332ms
2026-04-15 00:27:11.238546	200	556ms
2026-04-14 04:00:31.575606	200	1002ms
2026-04-14 02:26:46.467708	200	533ms
2026-04-14 00:49:24.984400	200	318ms
2026-04-12 16:33:45.390589	200	610ms
2026-04-12 16:08:25.909635	200	529ms
2026-04-12 15:41:36.830292	200	886ms
2026-04-10 02:55:29.534825	200	322ms
2026-04-10 02:24:03.494005	200	552ms
2026-04-10 00:21:27.667102	200	736ms
2026-04-09 01:56:19.269028	200	382ms
2026-04-09 01:33:52.851936	200	487ms
2026-04-09 01:31:03.374518	200	957ms
2026-03-23 10:21:16.827455	200	527ms