counts: Count earthquake events

API: earthscope.org:earthscopeiris-seismic-web-services
Endpoint: /event/1/counts
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 404
Latency: 807ms

Description

Returns the number of earthquake events that match the given query parameters without returning full event details. Use this to estimate result set size before running a full query or for statistical analysis.

From spec: Get a count of events matching the specified criteria. Supports the same parameters as /query except for pagination and inclusion options.

Usage Tips

- Supports all the same filter parameters as /event/query - Useful for validating query constraints before fetching full data - Returns a simple integer count - Much faster than full query for large result sets

Parameters (19)

catalog (string, query, optional, default: NEIC+PDE)

Specify the catalog from which origins and magnitudes will be retrieved

contributor (string, query, optional)

Limit to events contributed by a specified contributor

endtime (string, query, optional)

Limit to events/stations/data on or before the specified end time (ISO 8601 format)

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

Output format for event data

Constraints: {'enum': ['xml', 'text']}

latitude (number, query, optional, default: 0)

Central latitude point for radial search (degrees)

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

longitude (number, query, optional, default: 0)

Central longitude point for radial search (degrees)

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

magnitudetype (string, query, optional)

Type of magnitude used to test minimum and maximum limits (case insensitive)

maxdepth (number, query, optional)

Limit to events with depths equal to or less than the specified depth (km)

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

Northern boundary for rectangular search (degrees)

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

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

Eastern boundary for rectangular search (degrees)

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

maxmagnitude (number, query, optional)

Limit to events with magnitude smaller than or equal to the specified maximum

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

Maximum distance from the geographic point (degrees)

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

mindepth (number, query, optional)

Limit to events with depths equal to or greater than the specified depth (km)

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

Southern boundary for rectangular search (degrees)

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

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

Western boundary for rectangular search (degrees)

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

minmagnitude (number, query, optional)

Limit to events with magnitude larger than or equal to the specified minimum

minradius (number, query, optional, default: 0)

Minimum distance from the geographic point (degrees)

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

starttime (string, query, optional)

Limit to events/stations/data on or after the specified start time (ISO 8601 format)

updatedafter (string, query, optional)

Limit to events/stations updated after the specified time

Examples (1)

Count earthquakes in California region for 2023 doc_extracted

Demonstrates counting events within a geographic bounding box, useful for estimating data volume before running full queries

curl 'https://service.earthscope.org/fdsnws/event/1/counts?starttime=2023-01-01&endtime=2023-12-31&minlat=32&maxlat=37&minlon=-125&maxlon=-114&minmagnitude=3.0'

import requests

resp = requests.get(
    "https://service.earthscope.org/fdsnws/event/1/counts",
    params={
        'starttime': '2023-01-01',
        'endtime': '2023-12-31',
        'minlat': '32',
        'maxlat': '37',
        'minlon': '-125',
        'maxlon': '-114',
        'minmagnitude': '3.0',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("earthscope")
result = api.fetch("event/1/counts", starttime="2023-01-01", endtime="2023-12-31", minlat=32, maxlat=37, minlon=-125, maxlon=-114, minmagnitude=3.0)

for item in result:
    print(item)

const resp = await fetch("https://service.earthscope.org/fdsnws/event/1/counts?starttime=2023-01-01&endtime=2023-12-31&minlat=32&maxlat=37&minlon=-125&maxlon=-114&minmagnitude=3.0");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 02:13:23.037810	404	807ms
2026-04-15 00:39:45.994141	404	1220ms
2026-04-14 00:53:42.398948	404	1087ms
2026-04-12 15:45:24.122668	404	1313ms