USGS Water Data APIs
This site is the home for modernized access to USGS water data in machine-readable formats via REST APIs, a common type of web service programs use to search and download data. These services provide USGS water data, ranging from continuous measurements of streamflow to information about individual USGS sites and more. The links below lead to documentation for how to use each service, and web forms to build queries for each endpoint.
-
Latest Continuous Values
This API provides the most recent real-time measurements of streamflow, gage height, and hundreds of other parameters for USGS monitoring locations.
-
Daily Values
Interested in historical summarized daily data about our nation's streams, lakes and wells? This API provides a wealth of historical water data. Daily data is available for USGS water monitoring locations include mean, median, maximum, minimum, and/or other derived values.
-
Monitoring Locations
Location information is basic information about the monitoring location including the name, identifier, agency responsible for data collection, and the date the location was established. It also includes information about the type of location, such as stream, lake, or groundwater, and geographic information about the location, such as state, county, latitude and longitude, and hydrologic unit code (HUC).
-
Time Series Metadata
Daily data and continuous measurements are grouped into time series, which represent a collection of observations of a single parameter, potentially aggregated using a standard statistic, at a single monitoring location. This endpoint provides metadata about those time series, including their operational thresholds, units of measurement, and when the earliest and most recent observations in a time series occurred.
-
OGC-Compliant APIs
USGS offers Open Geospatial Consortium (OGC) compliant APIs, which will let you download continuous service measurements, discrete field measurements, metadata about monitoring locations, and more. These services all share a standard interface and documentation.
-
Water Quality Services
The USGS and the U.S. Environmental Protection Agency (EPA) each collect vast amounts of water quality data. The Water Quality Portal provides publicly available discrete water-quality data from the USGS, EPA, and over 400 state, federal, tribal, and local agencies in Water Quality Exchange (WQX) 3 formats, while the USGS Samples API provides direct API access to USGS discrete water quality observations.
-
USGS Water Data Statistics
This service provides endpoints for access to computations on the historical record regarding water conditions.
-
Real-Time Flood Impacts
The Real-Time Flood Impact (RTFI) API exposes the locations, called Flood Impact Locations, where the USGS measured the height of critical safety or infrastructure that may be vulnerable to flooding. Examples of Flood Impact Locations include embankments, roads and bridges, pedestrian paths, and buildings. Flood Impact Locations are surveyed and associated with a nearby USGS real-time streamgage.
-
National Imagery Management System (NIMS)
The National Imagery Management System (NIMS) is a comprehensive infrastructure designed to collect, store, process, and deliver imagery collected by cameras managed by the U.S. Geological Survey (USGS) for public and scientific use. NIMS supports a wide range of hydrologic and environmental monitoring applications.