What’s Out There
← Back to swiping
Earth scienceFreeNational government

USGS Water Data APIs (streamflow and groundwater time series)

U.S. Geological Survey (USGS)

Live river flow from thousands of U.S. stream gauges, some with records running back over a century.

The USGS Water Data APIs serve the agency's water monitoring records: continuous readings of streamflow, gage height, and hundreds of other parameters, daily summary values, and site metadata for streams, lakes, and wells. They are the modernized replacement for the legacy NWIS web services. Hydrologists, flood forecasters, and anglers all draw on it.

Access

Cost
FreeFree; an optional free API key raises rate limits.
License
Public domainPublic domain (U.S. government work)
Sign-up
No sign-up
How you get it
APIJSON, GeoJSON, CSV

What's in it

One row is
One observation of one parameter at one monitoring location and time (continuous or daily value)
Covers
United States and territories, by monitoring location
Years
Late 1800s-present at the oldest gauges; most sites cover shorter spans
Updated
Real time
Size
Not stated
monitoring location IDparameter codetimevaluestatisticapproval statushydrologic unit code

Quality

5 of 5

Long, carefully reviewed gauge records that underpin U.S. flood and drought science.

  • Recent data are provisional and can be revised
  • Legacy NWIS endpoints are being retired, so older scripts may break

Connects to

Questions it could answer

  • Are peak spring flows arriving earlier in snowmelt-fed western rivers?
  • How far have groundwater levels fallen in High Plains aquifer wells since 1980?

Similar data sets