Water Quality Monitoring API

Access Kentucky Water Watch monitoring site data and water quality samples programmatically via our GeoJSON API. This API provides multiple query modes for different use cases, from simple site listings to detailed historical data.

API Overview

Base Endpoint

https://kyww.uky.edu/api/wwky-data

Response Format

All endpoints return data in standard GeoJSON format:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "id": 12345,
        "name": "Stream Name",
        "basin": "Basin Name"
        // Additional properties vary by mode
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-84.5, 38.0]
      }
    }
  ]
}

Authentication

This is a public API and does not require authentication.

Best Practices

Use the appropriate mode for your use case to minimize data transfer
Apply filters in flat mode when querying large datasets
Set reasonable limits to avoid timeouts with nested or flat modes
Cache responses when appropriate, especially for sites mode
Handle null values - not all samples contain all measurements
Rate limiting - Please be considerate with API usage. For bulk data needs, consider caching responses locally

Support

For questions or issues with this API, please contact the Kentucky Water Watch team or visit www.kywater.org.