NGF: Web Services

These services may be used under EarthScope Terms of Service. Usage of the services and data in publications should cite the services according to our citation instructions and data by network.

Service Implementations

FDSNWS

Service Interface	Version	Summary	Return options
station	v.1	metadata for time series stored in SEED format	FDSN StationXML Text
dataselect	v.1	time series data in miniSEED and other formats	miniSEED SAC zip GeoCSV

IRISWS

Service Interface	Version	Summary	Return options
fedcatalog	v.1	A service for federating requests for channel metadata across multiple data centers	text, request
nrl	v.1	A service for integrating with the Nominal Response Library	__json, xml, StationXML, StationXML-Response, SEED RESP
syngine	v.1	A service for synthetic seismograms	SACZIP and miniSEED
timeseriesplot	v.1	A charting webservice offering timeseries graphic display in single-line or helicorder styles	image: PNG (default) or JPEG
evalresp	v.1	instrument response information evaluated from IRIS metadata	ASCII : frequency-amplitude-phase ASCII : complex-spectra Bode style plots
virtualnetwork	v.1	list of stations in a virtual network	XML CVS
mars-event	v.1	Martian seismic events (marsquakes) from the NASA InSight mission to Mars	XML Text
metadatachange	v.1	changes made to SEED metadata	XML

MUSTANG

Service Interface	Version	Summary	Return options
measurements	v.1	The main MUSTANG web service returning measurements for metrics relating to station data quality.	XML (default) text CSV JSON JSONP
noise-psd	v.1	Returns Power Spectral Density (PSD) estimates of seismic data and can generate aggregate plots.	Text – CSV XML Plot (PNG)
noise-pdf	v.1	Returns Probability Density Functions (PDFs) in frequency `bins` and can generate aggregate plots.	Text – CSV XML Plot (PNG)
noise-spectrogram	v.1	Returns seismic spectrogram images based on daily PDF mode values	Plot (PNG)
noise-pdf-browser	v.1	Returns browseable views of MUSTANG PDF plots and spectrogram plots	Text JSON HTML
noise-mode-timeseries	v.1	Returns PDF daily modes and mode timeline plots	Text – CSV XML Plot (PNG)
metrics	v.1	The metrics web service returns a description of available metrics in a variety of formats	XML HTML XSD JSON JSONP
targets	v.1	The targets web service returns a list of stations and channels for a given metric.	Text

Overview

Web services can be accessed in a number of different ways:

Small requests can be handled through your browser.
Dedicated clients are available for making more complex or larger queries.
Automated or scripted requests can be made using programs such as wget or curl.
A Java API is available for Java and MATLAB users.

Subscribe to the Earthscope data-announcements list to receive announcements of services changes and interruptions, beta releases and to take part in discussions related to the services or ask for help.

These services may be used under EarthScope Terms of Service. Usage of the services and data in publications should cite the services according to our citation instructions and data by network.

Real time data

All open data arriving in (near) real time at the NSF National Geophysical Facility are available from the SeedLink server.

The web services should not be used to retrieve continuous, real time data via repeated polling. Instead, the SeedLink server should be used when continuous data streams are needed.