Developer Platform
Access FishFYI data through our REST API, markdown endpoints, and feeds.
📖
API Docs
Interactive Swagger UI
📋
OpenAPI Schema
Machine-readable spec
🤖
llms.txt
AI-friendly site summary
📡
Feeds
RSS & Atom feeds
REST API Endpoints
All endpoints return JSON. Paginated with ?limit= and ?offset=.
Use ?lang=ko for translated fields.
| Endpoint | Description | Filters |
|---|---|---|
| /fish/ | List all fish species | |
| /fish/{slug}/ | Fish species detail | |
| /orders/ | List all taxonomic orders | |
| /order/{slug}/ | Taxonomic order detail | |
| /family/{slug}/ | Taxonomic family detail | |
| /countries/ | List all countries | |
| /country/{code}/ | Country detail | |
| /methods/ | List all fishing methods | |
| /method/{slug}/ | Fishing method detail | |
| /water-bodies/ | List all water bodies | |
| /water-body/{slug}/ | Water body detail | |
| /glossary/ | List glossary terms | |
| /glossary/{slug}/ | Glossary term detail | |
| /guides/ | List published guides | |
| /guide/{slug}/ | Guide detail |
Markdown Endpoints
Append .md to any page URL to get a markdown version.
# Fish profile
curl https://fishfyi.com/fish/atlantic-salmon.md
# Guide article
curl https://fishfyi.com/guide/beginner-fly-fishing.md
# With language prefix
curl https://fishfyi.com/ko/fish/atlantic-salmon.md
Quick Start
curl
# List fish species
curl https://fishfyi.com/api/fish/
# Search
curl "https://fishfyi.com/api/search/?q=salmon"
# Filter by water type
curl "https://fishfyi.com/api/fish/?water_type=freshwater"
# Database stats
curl https://fishfyi.com/api/stats/
Python
import httpx
resp = httpx.get("https://fishfyi.com/api/fish/",
params={"water_type": "saltwater", "limit": 10})
fish = resp.json()["results"]