USGS Water & Streamflow Scraper — Discharge & Gage Height

Pull US stream-gauge data straight from USGS monitoring sites with the USGS Water & Streamflow Scraper. Get streamflow (discharge), gage height, water temperature and more — as daily or instantaneous values — for any site, state or map area, and export each reading as JSON, CSV or Excel.

Built for water and reservoir management, flood and drought monitoring, hydrological research, and recreation apps (paddling, fishing, rafting), it turns the national water-monitoring network into a clean, tabular dataset.

What it does

• 🌊 Streamflow & stage — discharge (ft³/s), gage height (ft), water temperature and other parameters.
• 🗺️ Query any way — by site number, by US state, or by a bounding-box map area.
• 🕒 Daily or instantaneous — one value per day, or sub-hourly readings for a recent period.
• 🧱 Tidy rows — one row per observation with site, parameter, value, unit and timestamp.
• 📍 Site coordinates — latitude/longitude for every monitoring site.
• 📤 Export anywhere — JSON, CSV or Excel, or straight into an alert, model or dashboard.

Example output

{
  "site": "01646500",
  "siteName": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
  "latitude": 38.9497,
  "longitude": -77.1278,
  "parameterCode": "00060",
  "parameter": "Streamflow, ft³/s",
  "value": 5750,
  "unit": "ft³/s",
  "dateTime": "2024-06-01T00:00:00.000"
}

How to use it

1. Enter site numbers, or a state code, or a bounding box.
2. Choose the parameters (discharge, gage height…) and daily or instantaneous values.
3. Set a date range or period, run, and download as JSON, CSV or Excel.

Input fields

Field	Description
Site numbers	USGS site numbers to fetch (e.g. 01646500).
State code	Two-letter US state to fetch all matching sites (md, ca…).
Bounding box	west,south,east,north degrees for a map area.
Parameter codes	00060 discharge, 00065 gage height, 00010 temperature, and more.
Data service	Daily values or instantaneous (sub-hourly) values.
Start / End date	Explicit date range as YYYY-MM-DD.
Period	Relative window (P7D, P1M…) when no date range is set.
Max observations	Cap on total rows (0 = no limit).

Output fields

site, siteName, latitude, longitude, parameterCode, parameter, parameterDescription, value, unit, dateTime, qualifiers.

Popular use cases

• Flood & drought monitoring — track discharge and stage against thresholds.
• Water & reservoir management — feed live flow into operations dashboards.
• Research & modeling — build long streamflow time series for any basin.
• Recreation apps — surface current flow for paddling, fishing and rafting.
• Alerts — notify when a gauge rises or falls past a set level.

FAQ

Do I need an account or key? No. Enter your sites or area and run.

What parameters can I get? Discharge (00060), gage height (00065), water temperature (00010) and many other USGS parameter codes.

Daily or instantaneous? Daily gives one value per day over long ranges; instantaneous gives sub-hourly readings for a recent period.

How do I find site numbers? Query by state or bounding box to discover sites, then reuse their site numbers for targeted pulls.

Can I export to Excel or Google Sheets? Yes — results download as JSON, CSV or Excel and integrate with alerts, models and dashboards.

---

Structured USGS streamflow and water data — discharge, gage height and more by site, state or area — clean and export-ready for water management, research and alerts.