Sign up
All data sources

USGS Water Data

Free

Current USGS continuous, daily, groundwater, and monitoring-location data via OGC API v0.

Set up this sourceGet the full contract and schemas as JSONConnect this source →

No key required. Included on Free.

What you can ask

  • “What does USGS Water Data have for the area or asset I'm working on?”
  • “Pull the most recent USGS Water Data records and put them in a table.”
  • “What does USGS Water Data cover, and how fresh is the data?”

About this source

Current USGS Water Data OGC API v0 for bounded continuous, daily, groundwater field-measurement, and monitoring-location reads.

Connector ID usgs-water

Provenance

PublisherUSGS Water Data OGC API v0
Sourcehttps://api.waterdata.usgs.gov/ogcapi/v0/
API basehttps://api.waterdata.usgs.gov/ogcapi/v0
Docshttps://api.waterdata.usgs.gov/docs/ogcapi/

Freshness & coverage

FreshnessNear real-time
GeographicUnited States and USGS monitoring locations
TemporalNot declared
AuthenticationNo credentials required

Caveats

  • ⚠ USGS still labels this API v0; breaking changes are reserved for a future versioned URL.
  • ⚠ Continuous observations may be provisional and can arrive after collection.
  • ⚠ Observation collections return one feature per observation, unlike legacy WaterML grouping.
  • ⚠ Monitoring locations cannot be filtered directly by parameter code.

› Methods (6)

Technical detail for developers: parameters, pagination, units, and freshness per method.

  • getServiceInfo

    read

    Describe the exact OGC collections, limits, parameter codes, and migration caveats.

    Entitiesservice
    Paginationnone
    FreshnessNear real-time (source-level)

  • getInstantaneousValues

    read

    Get bounded continuous observations or the latest value for named USGS sites.

    Required paramssites or site or siteCode or siteId
    Entitiescontinuous-observation
    Paginationoffset (offsetField: offset, limitField: limit)
    FreshnessNear real-time

  • getDailyValues

    read

    Get bounded daily statistical observations for named USGS sites.

    Required paramssites or site or siteCode or siteId
    Entitiesdaily-observation
    Paginationoffset (offsetField: offset, limitField: limit)
    FreshnessScheduled

  • getSiteInfo

    read

    Get normalized monitoring-location metadata for up to 50 exact USGS site numbers.

    Required paramssites
    Entitiesmonitoring-location
    Paginationnone
    FreshnessNear real-time (source-level)

  • searchSites

    read

    Search monitoring locations by exactly one bbox, county FIPS, or state postal code.

    Required paramsbbox or boundingBox or countyCd or countyCode or stateCd or state
    Entitiesmonitoring-location
    Paginationoffset (offsetField: offset, limitField: maxResults)
    CRSOGC CRS84
    FreshnessNear real-time (source-level)

  • getGroundwaterLevels

    read

    Get bounded discrete groundwater field measurements by sites or bbox.

    Required paramssites or site or siteCode or siteId or bbox or bBox
    Entitiesgroundwater-field-measurement
    Paginationoffset (offsetField: offset, limitField: limit)
    CRSOGC CRS84
    FreshnessNear real-time (source-level)