AI-Native Fishing Intelligence
Live, structured data contracts mapping Steelhead Alley conditions, forecasts, and storm alerts for LLMs, custom GPTs, and developers.
API Endpoint Registry
Versioned under /api/public/v1/*. Responses are cached for 5 minutes with stable ETags.
Retrieves the current composite index score, 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",
"trend": "rising",
"sub_indices": {
"flow": { "score": 82, "label": "Optimal" }
}
}
}
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.
{
"api_version": "1.0",
"data": {
"region": "oh-erie",
"alley_index_score": 78,
"top_picks": [
{ "slug": "elk-creek", "rating": "excellent", "score": 92 }
]
}
}
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
}
}
Custom GPT Actions
Query real-time fishing reports directly during conversations with Custom GPTs.
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.
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.