API Version 1.0 (Frozen)

AI-Native Fishing Intelligence

Live, structured data contracts mapping Steelhead Alley conditions, forecasts, and storm alerts for LLMs, custom GPTs, and developers.

Live Alley Index
60/100
Condition Descriptor
Average

API Endpoint Registry

Versioned under /api/public/v1/*. Responses are cached for 5 minutes with stable ETags.

GET /api/public/v1/alley-index
Cache TTL: 5m

Retrieves the current composite index score, 24-hour trends, sub-indices (flow, clarity, temperature, weather), a 7-day forecast, and active storm flags.

Example Request
curl https://steelheadaddiction.com/api/public/v1/alley-index
Response Preview
{
  "api_version": "1.0",
  "data": {
    "score": 78,
    "label": "Good",
    "trend": "rising",
    "sub_indices": {
      "flow": { "score": 82, "label": "Optimal" }
    }
  }
}
GET /api/public/v1/conditions/summary
Cache TTL: 5m

Provides a region-wide conditions summary containing top picks (rivers rated good or excellent), a watch list for improving waters, a skip list for blown-out creeks, and data coverage metrics.

Example Request
curl https://steelheadaddiction.com/api/public/v1/conditions/summary?region=oh-erie
Response Preview
{
  "api_version": "1.0",
  "data": {
    "region": "oh-erie",
    "alley_index_score": 78,
    "top_picks": [
      { "slug": "elk-creek", "rating": "excellent", "score": 92 }
    ]
  }
}
GET /api/public/v1/rivers/{slug}
Cache TTL: 5m

Retrieves current conditions, historical flow percentile rank, flow phase, weather, recommended flies/techniques, storm lifecycle payload, and a 5-day forecast for a single tributary. Supports slug aliasing (e.g. chagrin maps to chagrin-river).

Example Request
curl https://steelheadaddiction.com/api/public/v1/rivers/chagrin-river
Response Preview
{
  "api_version": "1.0",
  "data": {
    "slug": "chagrin-river",
    "name": "Chagrin River",
    "state": "OH",
    "rating": "good",
    "flow_cfs": 220,
    "is_fishable": true
  }
}

Custom GPT Actions

Query real-time fishing reports directly during conversations with Custom GPTs.

Private Beta Testing against /openapi.json

Steelhead Alley Assistant

A specialized Custom GPT equipped with real-time fishing reports. Anglers can naturally query current river flows, clarity rankings, optimal travel dates, and local fly recommendations. Private beta is currently testing API interactions directly against the OpenAPI schema.

OpenAPI Specification

Static, hand-maintained API schema validation file.

openapi.json

Our contract definition conforms to OpenAPI 3.0.3. The specification enforces type safety, enums, required fields, and forbids unexpected properties. It is automatically validated against live endpoints on every test execution.

llms.txt Discovery

Machine-readable index mapping for crawlers and LLM clients.

llms.txt Mappings

Located at the root of the domain, llms.txt provides LLMs, developer agents, and search crawlers with a summary index of active endpoints, key response formats, example queries, and proper attribution formats.

Rate Limiting & Cache Controls

We employ custom rate limits based on client user-agent mapping to ensure fair access.

Endpoint Group Anonymous IP Classified LLM Bot Header Keys
/alley-index, /conditions/summary 60 req / min 120 req / min X-RateLimit-Limit
X-RateLimit-Remaining
/rivers/{slug} 30 req / min 90 req / min X-RateLimit-Limit
X-RateLimit-Remaining

Attribution & Citation Policy

All API responses carry an attribution string in their metadata envelope. If you digest or republish our live rating values, weather calculations, or forecasts in an LLM application, we require visible credit to be given.

"Source: SteelHead Addiction (steelheadaddiction.com)"

We encourage linking back to the canonical URL provided in the metadata block when citing specific tributaries.

Need higher limits or custom payloads?

If you are building commercial integrations, widgets, or need direct raw data streams, get in touch with our team.

partnerships@steelheadaddiction.com

Scan to visit

SteelHead Addiction QR Code

SteelHead Addiction

steelheadaddiction.com