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
Quality
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
- Global Runoff Data Centre (GRDC) River Discharge: International river discharge records in a comparable daily format
- JPL GRACE and GRACE-FO Mascons: Compare basin water storage change from gravity with gauge flows and well levels
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?