What it returns
Live readings from the US Geological Survey's network of river and stream gauges, from the USGS National Water Information System. Public domain, most gauges report every 15 minutes.
Common uses
Fishing, paddling and rafting apps, flood and drought alerts, hydropower and agriculture, insurance, logistics on inland waterways, research and dashboards. Pay per reading returned.
Request
POST https://api.pushbuild.com/usgs-river-streamflow/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
sites | string | USGS site numbers, comma separated, e.g. 01646500 |
state | string | Two-letter code. Used when no gauge IDs are given. |
boundingBox | string | west,south,east,north in decimal degrees, e.g. -74.1,40.6,-73.7,40.9 |
huc | string | 2- or 8-digit hydrologic unit code |
countyFips | string | 5-digit code, e.g. 50005 |
parameters | list of strings | Default: ["00060", "00065"]. |
history | boolean | One row per reading (usually every 15 minutes) instead of the latest only. Default: false. |
days | integer | Used with Full history. Default: 1. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/usgs-river-streamflow/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"state": "VT", "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 readings. No charge for errors or empty searches.
Related APIs
Italy Train Status API: Trenitalia Live Delays API
Live status of Italian trains (Frecciarossa, Intercity, Regionale) from the official ViaggiaTreno feed: every stop with scheduled and actual times, delay and platform, or a station's live departures and arrivals board..
Private Jet Tracker API: Live Positions & FAA Owners API
Live positions of private and business jets from open ADS-B data, joined to the FAA registry owner: track by tail number, transponder hex, owner name (e.g.
Private Jet Trips API: Flights by Tail, Owner & Airport API
Recent private and business jet trips with departure and arrival airports, times and duration, recorded from open ADS-B data every 10 minutes and joined to FAA registered owners.
Public Holidays API
Public and bank holidays for 100+ countries by year or date range, with regional (state/province) holidays, holiday types, long weekends with bridge days, worldwide upcoming holidays, and an is-it-a-holiday check for any list of dates..
Tide Times API
Official NOAA tide predictions (high/low and hourly), observed water levels, water and air temperature, wind and pressure for 3,000+ US coastal stations.
TSA Checkpoint Travel Numbers + BTS Transportation Stats API
Daily TSA airport checkpoint passenger counts since 2019 with year-over-year and 7-day averages, plus BTS monthly transportation statistics: airline passengers, on-time performance, air cargo, freight rail, trucking, transit and the Transportation Services Index..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com