USGS - science for a changing world

REST Web Services

What is REST?

REST is a "URL friendly" way to retrieve data (generally in an XML format) over the web. For more details, please read this Wikipedia explanation External Link.

Available REST Web Services

Instantaneous Values (IV) Web Service

This service lets you acquire near real-time water data from thousands of sites managed or monitored by the USGS across the country. Readings are usually made every 15 minutes and transmitted hourly. Data is currently available since October 1, 2007. Note: certain operational data is typically restricted to 120 days. A number of flexible filters allow you to find data about sites of common interest easily.

Site Service

The USGS has information about millions of sites: locations where hydrologic (water) data is or has been collected. There are thousands of real-time alone. The site service allows you to find relevant sites of interest using a number of flexible filters, and provides key metadata about each site as well as optional information on the type of data collected at the site and the data collection period.

Daily Values (DV) Web Service

Daily values are summarized data about our nation's streams, spring, lakes and wells derived from regular time-series equipment at these sites. Daily daily available for USGS water sites include mean, median, maximum, minimum, and/or other derived values. Many sites have periods of record for a decade or more. This service allows you to find daily values for time-series sites, both current and historical, using a number of flexible filters.

Water Quality Web Services

The USGS and the U.S. Environmental Protection Agency (EPA) each collect vast amounts of water quality data. A jointly developed web service allows you to retrieve data for millions of quality checked water quality samples and results.

Groundwater Levels Web Service

You can use this service to retrieve historical manually-recorded groundwater levels from hydrologic sites served by the USGS. If you are looking to retrieve data for real-time or recent groundwater levels recorded with automated equipment on a regular basis, please use the instantaneous values web service.

Statistics Web Service

Retrieve daily, monthly or annual statistics for sites. Statistics are provided on approved data only for time-series sites. Statistics are available for any parameter on these sites with approved data. Statistics include mean, minimum, maximum, mean and various percentiles.