query: Retrieve seismic waveform data

API: earthscope.org:earthscopeiris-seismic-web-services
Endpoint: /dataselect/1/query
Response format: application/vnd.fdsn.mseed
Auth: unknown
Method: GET
Last Status: 200
Latency: 412ms

Description

Downloads seismic time series data (waveforms) in miniSEED format for specified stations, channels, and time ranges. This is the primary endpoint for accessing raw seismic recordings.

From spec: Download seismic time series data in miniSEED or GeoCSV format. Requires network, station, and time range parameters.

Usage Tips

- Returns miniSEED binary data; use format=geocsv for text output - Must specify network, station, location, channel codes (use wildcards if needed) - Maximum request duration may be limited; large requests may be split - Channels: BHZ (broadband vertical), HHZ (high broadband), etc. - Requires valid time range; data must exist at the datacenter

Parameters (9)

cha (string, query, optional)

Channel code(s). Accepts wildcards and comma-separated lists.

end (string, query, required)

End time for data request (ISO 8601 format)

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

Output format for waveform data

Constraints: {'enum': ['miniseed', 'geocsv', 'geocsv.slist', 'geocsv.inline', 'geocsv.zip']}

loc (string, query, optional)

Location code(s). Accepts wildcards and comma-separated lists. Use -- for blank locations.

net (string, query, optional)

Network code(s). Accepts wildcards (? and *) and comma-separated lists.

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

Specify which HTTP status code is returned when no data is found

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

scale (string, query, optional)

Scale timeseries values by instrument sensitivity (GeoCSV only)

Constraints: {'enum': ['AUTO']}

sta (string, query, optional)

Station code(s). Accepts wildcards and comma-separated lists.

start (string, query, required)

Start time for data request (ISO 8601 format: YYYY-MM-DDThh:mm:ss)

Examples (1)

Download waveform data for ANMO station doc_extracted

Demonstrates requesting 5 minutes of seismic waveform data for a specific station and channel

curl 'https://service.earthscope.org/fdsnws/dataselect/1/query?net=IU&sta=ANMO&loc=00&cha=BHZ&starttime=2024-01-15T00%3A00%3A00&endtime=2024-01-15T00%3A05%3A00'
import requests

resp = requests.get(
    "https://service.earthscope.org/fdsnws/dataselect/1/query",
    params={
        'net': 'IU',
        'sta': 'ANMO',
        'loc': '00',
        'cha': 'BHZ',
        'starttime': '2024-01-15T00:00:00',
        'endtime': '2024-01-15T00:05:00',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("earthscope")
result = api.fetch("dataselect/1/query", net="IU", sta="ANMO", loc=00, cha="BHZ", starttime="2024-01-15T00:00:00", endtime="2024-01-15T00:05:00")

for item in result:
    print(item)
const resp = await fetch("https://service.earthscope.org/fdsnws/dataselect/1/query?net=IU&sta=ANMO&loc=00&cha=BHZ&starttime=2024-01-15T00%3A00%3A00&endtime=2024-01-15T00%3A05%3A00");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 02:50:24.945572 200 412ms
2026-04-15 03:54:49.691736 200 520ms
2026-04-14 01:37:43.105364 200 633ms
2026-04-12 12:38:18.830980 200 842ms