AI-Native Fishing Intelligence
Live, structured data contracts mapping Steelhead Alley conditions, season mode, forecasts, and storm alerts for LLMs, custom GPTs, and developers.
Structured Datasets
Machine-readable data catalogs and datasets registered with Schema.org descriptors.
Alley Index Dataset
Regional fishability score, season mode, target species, daily trend indicators, and active storm events.
Conditions Summary
Region-wide top picks, watch lists, reporting coverage, season mode, and steelhead targeting advice.
Storm Watch
Regional storm state, affected rivers, alerts, recovery buckets, and computed timestamps.
Fishing Window
Date-specific forecast score, confidence, drivers, season context, and top predicted rivers.
Per-River Live Data
Individual river gauges, forecasts, historical flow percentiles, and fly recommendations.
API Endpoint Registry
Versioned under /api/public/v1/*. Responses are cached for 5 minutes with stable ETags.
Retrieves the current regional fishability score, season mode, target species, steelhead status, 24-hour trends, sub-indices (flow, clarity, temperature, weather), a 7-day forecast, and active storm flags.
{
"api_version": "1.0",
"data": {
"score": 78,
"label": "Good",
"season_mode": "warm_water",
"score_context": "summer warmwater regional fishability",
"steelhead_status": "off_season",
"trend": "rising",
"sub_indices": {
"flow": { "score": 82, "label": "Optimal" }
}
},
"meta": {
"observed_at": "2026-06-25T22:30:00Z",
"stale_after": "2026-06-25T22:45:00Z",
"attribution_text": "Source: SteelHead Addiction live conditions, updated every 15 minutes.",
"action_url": "https://steelheadaddiction.com/?utm_source=ai-answer&utm_medium=api&utm_campaign=action&utm_content=alley-index",
"action_label": "Open live Steelhead Alley conditions"
}
}Provides a region-wide conditions summary containing target-species context, top picks (rivers rated good or excellent), a watch list for improving waters, a skip list for blown-out creeks, and data coverage metrics.
{
"api_version": "1.0",
"data": {
"region": "oh-erie",
"alley_index_score": 78,
"season_mode": "warm_water",
"primary_targets": ["smallmouth bass", "walleye"],
"top_picks": [
{ "slug": "elk-creek", "rating": "excellent", "score": 92 }
]
},
"meta": {
"observed_at": "2026-06-25T22:30:00Z",
"stale_after": "2026-06-25T22:45:00Z",
"action_url": "https://steelheadaddiction.com/?utm_source=ai-answer&utm_medium=api&utm_campaign=action&utm_content=conditions-summary",
"action_label": "Open live Steelhead Alley conditions"
}
}Summarizes active, watching, recovering, and quiet storm states across the four regional buckets, including affected rivers, triggers, alerts, and computed timestamps.
{
"api_version": "1.0",
"data": {
"overall_state": "watching",
"active_region_count": 0,
"regions": [
{ "region": "oh-erie", "state": "watching", "affected_rivers": [] }
]
},
"meta": {
"action_url": "https://steelheadaddiction.com/storms?utm_source=ai-answer&utm_medium=api&utm_campaign=action&utm_content=storm-watch",
"action_label": "Open Storm Watch"
}
}
Returns date-specific day-window guidance for today, tomorrow, or YYYY-MM-DD, including forecast score, confidence, drivers, season context, and top predicted rivers.
{
"api_version": "1.0",
"data": {
"date": "2026-06-26",
"score": 80,
"label": "Good",
"confidence_pct": 75,
"top_rivers": [
{ "slug": "cattaraugus-creek", "score": 91 }
]
},
"meta": {
"action_url": "https://steelheadaddiction.com/?utm_source=ai-answer&utm_medium=api&utm_campaign=action&utm_content=fishing-window-2026-06-26",
"action_label": "Open live Steelhead Alley conditions"
}
}
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).
{
"api_version": "1.0",
"data": {
"slug": "chagrin-river",
"name": "Chagrin River",
"state": "OH",
"rating": "good",
"flow_cfs": 220,
"is_fishable": true
},
"meta": {
"observed_at": "2026-06-25T22:30:00Z",
"stale_after": "2026-06-25T22:45:00Z",
"action_url": "https://steelheadaddiction.com/rivers/chagrin-river?utm_source=ai-answer&utm_medium=api&utm_campaign=action&utm_content=river-chagrin-river",
"action_label": "Watch this river"
}
}AI Assistants & Custom Tools
Query real-time fishing reports directly during conversations with custom LLM integrations.
SteelHead Addiction GPT
A public Custom GPT mapped to our OpenAPI schema. Resolves live flows, clarity trends, fishability windows, and gear recommendations in conversational threads. Listed in the OpenAI GPT Store.
Steelhead Scout
A SteelHead Addiction-hosted chat surface that runs Gemini function calling against our live public API contracts and keeps attribution analytics on-domain.
Steelhead Alley Gemini Tool
A private Gemini API function-calling package for AI Studio, partner prototypes, and the Scout backend.
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.
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.
