U.S. Geological Survey

USGS Water Data APIs

The USGS Water Data OGC APIs provide standardized access to USGS water monitoring data including continuous streamflow, daily values, groundwater levels, discrete water quality measurements, and monitoring location metadata. Implements OGC API Features standard with spatial and temporal filtering support.

GitHub OpenAPI

Documentation

📖
Documentation
https://api.waterdata.usgs.gov/docs/
📖
Authentication
https://api.waterdata.usgs.gov/signup/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/openapi/usgs-water-data-api-openapi.yaml

Examples

📝
Example
Monitoring Location Example

Schemas & Data

📊
JSONSchema
Monitoring Location Schema
📊
JSONSchema
Time Series Properties Schema

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-ld/usgs-water-data-api-context.jsonld
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/capabilities/usgs-water-data-collections.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/capabilities/usgs-water-data-monitoring-locations.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/capabilities/usgs-water-data-reference-data.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/capabilities/usgs-water-data-time-series-data.yaml

OpenAPI Specification

usgs-water-data-api-openapi.yaml Raw ↑