USGS Water Resources
Real-time and historical water monitoring data from the US Geological Survey. Streamflow, groundwater levels, and water quality readings for thousands of active monitoring sites across all 50 states.
USGS Water Resources endpoints
| Method | Endpoint | Description |
|---|---|---|
| Streamflow | ||
| GET |
streamflow_site_streamflow_site__site_number__get /streamflow/site/{site_number} |
Returns daily mean streamflow values for a specific USGS monitoring site. Defaults to the last 30 days. Site numbers are 8-digit USGS identifiers. Historical data is cached for 1… |
| GET |
streamflow_current_streamflow_current_get /streamflow/current |
Returns real-time streamflow (discharge) readings in cubic feet per second (cfs) for all active stream gauges in the specified state. Data is cached for 15 minutes. |
| Sites | ||
| GET |
list_sites_sites_get /sites |
Returns a list of active USGS water monitoring sites for a given state. Filter by type: 'stream' for streamflow gauges, 'groundwater' for groundwater wells. Results come from the… |
| Groundwater | ||
| GET |
groundwater_levels_groundwater_levels_get /groundwater/levels |
Returns the most recent groundwater level readings for active monitoring wells in the specified state. Values are depth-to-water in feet below land surface. Data cached for 15… |
| Water Quality | ||
| GET |
water_quality_water_quality_get /water-quality |
Returns real-time water quality readings for active monitoring sites in the specified state. Available parameters: streamflow (cfs), temperature (°C), oxygen (mg/L), ph (standard… |
| Meta | ||
| GET |
stats_stats_get /stats |
Returns summary statistics: total sites indexed, number of states covered, breakdown by site type, and API status. |
USGS Water Resources pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $15 / month | — |
|
| ULTRA Recommended | $39 / month | — |
|
| MEGA | $99 / month | — |
|