Active USGS streamflow gages in a US state, ranked API

Discovers active USGS streamflow gages in a US state and ranks them by current discharge, with flow class — a live directory of which rivers are reporting and how big they are. Answers 'which gages are active in DC?', 'biggest flows in a state right now?'.

Price$0.01per request

MethodPOST

Route/v1/climate/usgs-water-sites

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache1800s public

climatewaterusgsstreamflowrivergagediscoveryhydrologyus

API URLhttps://x402.hexl.dev/v1/climate/usgs-water-sites

Integration docs

Example request

{
  "state": "DC",
  "limit": 5
}

Example response

{
  "state": "DC",
  "totalActiveReporting": 6,
  "sites": [
    {
      "siteCode": "01648000",
      "name": "ROCK CREEK AT SHERRILL DRIVE WASHINGTON, DC",
      "latitude": 38.9725,
      "longitude": -77.04,
      "streamflowCfs": 81.7,
      "flowClass": "low"
    },
    {
      "siteCode": "01648010",
      "name": "ROCK CREEK AT JOYCE RD WASHINGTON, DC",
      "latitude": 38.96016667,
      "longitude": -77.04205556,
      "streamflowCfs": 23,
      "flowClass": "low"
    },
    {
      "siteCode": "01651800",
      "name": "WATTS BRANCH AT WASHINGTON, DC",
      "latitude": 38.90127778,
      "longitude": -76.94327778,
      "streamflowCfs": 0.6,
      "flowClass": "negligible"
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "2-letter US state code, e.g. 'DC'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15
    }
  },
  "required": [
    "state"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}