USGS Water Data

How to Use This API

1. Instantaneous Values for a Site

https://waterservices.usgs.gov/nwis/iv/?site=09380000&format=json

2. Daily Mean Discharge

https://waterservices.usgs.gov/nwis/dv/?site=09380000&format=json&startDT=2025-01-01&endDT=2025-12-31

3. Groundwater Levels

https://waterservices.usgs.gov/nwis/gwlevels/?site=37335207944501&format=json

4. JavaScript — Check River Level

fetch('https://waterservices.usgs.gov/nwis/iv/?site=09380000&format=json')
  .then(r => r.json())
  .then(d => {
    const ts = d.value.timeSeries[0];
    const val = ts.values[0].value[0];
    console.log(ts.sourceInfo.siteName);
    console.log('Value:', val.value, ts.variable.unit.unitCode);
    console.log('Time:', val.dateTime);
  });

5. Python — Get Recent Data

import requests

resp = requests.get('https://waterservices.usgs.gov/nwis/iv/', params={
    'site': '09380000',
    'format': 'json',
    'period': 'P1D'
})
data = resp.json()
ts = data['value']['timeSeries']
for series in ts:
    var = series['variable']
    val = series['values'][0]['value'][0]
    print(f"{var['variableName']}: {val['value']} {var['unit']['unitCode']}")