GET /count

usgs.gov:usgs-earthquake-api

Summary: Count events
Operation ID: countEvents
Auth: unknown
Description

Perform a count using same parameters as query endpoint

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 (1)

TitleTypeURLAction
Count earthquake events openapi-spec https://earthquake.usgs.gov/fdsnws/event/1/count

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:21:16.827455 200 527ms