US Geological Survey website screenshot

US Geological Survey

The US Geological Survey is a scientific agency of the United States government that conducts research on the natural resources, natural hazards, and environmental health of the United States. The USGS is responsible for monitoring and assessing the country's water, energy, mineral, and biological resources, as well as investigating geological hazards such as earthquakes, volcanoes, landslides, and floods. USGS provides a broad portfolio of public REST APIs covering earthquake data, water resources, geomagnetism, mapping, seismic design, and scientific data catalogs - all available without cost as US Government works.

6 APIs 0 Features
Federal GovernmentEarth ScienceEarthquakesWater DataGeospatialHazardsEnvironment

APIs

USGS Earthquake Catalog API

The USGS Earthquake Catalog API implements the FDSN Event Web Service Specification, providing real-time and historical access to global earthquake data from the USGS National E...

USGS Water Data OGC API

The USGS Water Data OGC APIs provide OGC-compliant interfaces to USGS water data including real-time continuous measurements from automated sensor networks, daily summary values...

USGS ScienceBase Catalog API

The USGS ScienceBase Catalog API provides access to USGS scientific data management infrastructure, enabling upload, documentation, sharing, and dynamic data services for USGS r...

USGS Geomagnetism Web Service

The USGS Geomagnetism Web Service provides programmatic access to geomagnetic data collected by USGS magnetic observatories across the United States and territories, supporting ...

USGS Seismic Design Data Web Services

The USGS Seismic Design Data Web Services provide parameter values from seismic design reference documents for building and infrastructure design, supporting compliance with ASC...

USGS National Map Services

The USGS National Map services provide geospatial data and elevation products via OGC web services, REST APIs, and download services covering topographic data, imagery, hydrogra...

Collections

USGS Earthquake Catalog API

OPEN

USGS Water Data OGC API

OPEN

Pricing Plans

Us Geological Survey Plans Pricing

1 plans

PLANS

Rate Limits

Us Geological Survey Rate Limits

2 limits

RATE LIMITS

FinOps

Us Geological Survey Finops

FINOPS

Semantic Vocabularies

Us Geological Survey Context

22 classes · 6 properties

JSON-LD

API Governance Rules

US Geological Survey API Rules

10 rules · 2 errors 4 warnings 4 info

SPECTRAL

JSON Structure

Usgs Earthquake Feature Structure

0 properties

JSON STRUCTURE

Example Payloads

Usgs Earthquake Query Example

3 fields

EXAMPLE

Resources

👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: USGS Water Data OGC API
  version: 0.49.2
request:
  auth:
    type: apikey
    key: api_key
    value: '{{api_key}}'
    placement: query
items:
- info:
    name: Collections
    type: folder
  items:
  - info:
      name: Get Landing Page
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/
      params:
      - name: f
        value: ''
        type: query
        description: Response format
    docs: Returns the API landing page with links to available resources.
  - info:
      name: List Collections
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections
      params:
      - name: f
        value: ''
        type: query
        description: Response format
    docs: Returns a list of all available data collections in the USGS Water Data API.
- info:
    name: Continuous Values
    type: folder
  items:
  - info:
      name: Query Continuous Values
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections/continuous-values/items
      params:
      - name: bbox
        value: ''
        type: query
        description: Bounding box for spatial filtering (minLon,minLat,maxLon,maxLat)
      - name: datetime
        value: ''
        type: query
        description: Date/time filter (RFC 3339 or ISO 8601, supports intervals with /)
      - name: limit
        value: ''
        type: query
        description: Maximum number of features to return
      - name: offset
        value: ''
        type: query
        description: Starting offset for pagination
      - name: filter
        value: ''
        type: query
        description: CQL2 text filter expression for advanced querying
      - name: f
        value: ''
        type: query
        description: Response format
      - name: properties
        value: ''
        type: query
        description: Comma-separated list of properties to include in response
      - name: sortby
        value: ''
        type: query
        description: Property name to sort results by (prefix with - for descending)
      - name: monitoringLocationIdentifier
        value: ''
        type: query
        description: USGS monitoring location identifier (e.g., USGS-01646500)
      - name: parameterCode
        value: ''
        type: query
        description: USGS parameter code for the measurement type (e.g., 00060 for discharge)
    docs: Returns high-frequency continuous measurement data from USGS automated sensor networks. Includes streamflow, gage
      height, temperature, and hundreds of other parameters measured at monitoring locations.
- info:
    name: Daily Values
    type: folder
  items:
  - info:
      name: Query Daily Values
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections/daily-values/items
      params:
      - name: bbox
        value: ''
        type: query
        description: Bounding box for spatial filtering (minLon,minLat,maxLon,maxLat)
      - name: datetime
        value: ''
        type: query
        description: Date/time filter (RFC 3339 or ISO 8601, supports intervals with /)
      - name: limit
        value: ''
        type: query
        description: Maximum number of features to return
      - name: offset
        value: ''
        type: query
        description: Starting offset for pagination
      - name: filter
        value: ''
        type: query
        description: CQL2 text filter expression for advanced querying
      - name: f
        value: ''
        type: query
        description: Response format
      - name: monitoringLocationIdentifier
        value: ''
        type: query
        description: USGS monitoring location identifier
      - name: parameterCode
        value: ''
        type: query
        description: USGS parameter code
      - name: statCode
        value: ''
        type: query
        description: Statistical code (e.g., 00003 for mean, 00001 for max)
    docs: Returns daily summary water data including mean, median, maximum, and minimum values for streams, lakes, and wells.
      Aggregates continuous sensor data into daily statistics.
- info:
    name: Monitoring Locations
    type: folder
  items:
  - info:
      name: Query Monitoring Locations
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations/items
      params:
      - name: bbox
        value: ''
        type: query
        description: Bounding box for spatial filtering (minLon,minLat,maxLon,maxLat)
      - name: limit
        value: ''
        type: query
        description: Maximum number of features to return
      - name: offset
        value: ''
        type: query
        description: Starting offset for pagination
      - name: filter
        value: ''
        type: query
        description: CQL2 text filter expression for advanced querying
      - name: f
        value: ''
        type: query
        description: Response format
      - name: monitoringLocationIdentifier
        value: ''
        type: query
        description: USGS monitoring location identifier
      - name: monitoringLocationType
        value: ''
        type: query
        description: Type of monitoring location (e.g., Stream, Lake, Well)
      - name: stateCd
        value: ''
        type: query
        description: Two-letter state abbreviation
      - name: countyCd
        value: ''
        type: query
        description: County FIPS code
      - name: hucCd
        value: ''
        type: query
        description: Hydrologic Unit Code (HUC)
    docs: Returns geographic and identification information for USGS water monitoring stations including names, identifiers,
      coordinates, and hydrologic unit codes.
  - info:
      name: Get Monitoring Location
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections/monitoring-locations/items/:featureId
      params:
      - name: featureId
        value: ''
        type: path
        description: Unique feature identifier for the monitoring location
      - name: f
        value: ''
        type: query
        description: Response format
    docs: Returns details for a single USGS water monitoring location by feature ID.
- info:
    name: Time Series Metadata
    type: folder
  items:
  - info:
      name: Query Time Series Metadata
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections/time-series-metadata/items
      params:
      - name: bbox
        value: ''
        type: query
        description: Bounding box for spatial filtering (minLon,minLat,maxLon,maxLat)
      - name: limit
        value: ''
        type: query
        description: Maximum number of features to return
      - name: offset
        value: ''
        type: query
        description: Starting offset for pagination
      - name: filter
        value: ''
        type: query
        description: CQL2 text filter expression for advanced querying
      - name: f
        value: ''
        type: query
        description: Response format
      - name: monitoringLocationIdentifier
        value: ''
        type: query
        description: USGS monitoring location identifier
    docs: Returns metadata about grouped observations including operational thresholds, units of measurement, and time series
      characteristics for USGS monitoring locations.
- info:
    name: Field Measurements
    type: folder
  items:
  - info:
      name: Query Field Measurements
      type: http
    http:
      method: GET
      url: https://api.waterdata.usgs.gov/ogcapi/v0/collections/field-measurements/items
      params:
      - name: bbox
        value: ''
        type: query
        description: Bounding box for spatial filtering (minLon,minLat,maxLon,maxLat)
      - name: datetime
        value: ''
        type: query
        description: Date/time filter (RFC 3339 or ISO 8601, supports intervals with /)
      - name: limit
        value: ''
        type: query
        description: Maximum number of features to return
      - name: offset
        value: ''
        type: query
        description: Starting offset for pagination
      - name: filter
        value: ''
        type: query
        description: CQL2 text filter expression for advanced querying
      - name: f
        value: ''
        type: query
        description: Response format
      - name: monitoringLocationIdentifier
        value: ''
        type: query
        description: USGS monitoring location identifier
    docs: Returns physically measured values collected during site visits by USGS hydrographers, including streamflow measurements
      used to define rating curves for continuous data.
bundled: true