# FishFYI

> Interactive fish encyclopedia. 35,729 fish species, 627 families across 98 orders, 15 fishing methods, 40 water bodies, 197 countries, 48 regions, 1,200 seasonal fishing entries, 80 glossary terms, 20 guides, and interactive ichthyology tools in 15 languages.

## Data Scope
- 35,729 fish species with scientific names, common names, conservation status (IUCN Red List)
- 627 taxonomic families in 98 orders (e.g. Perciformes, Salmoniformes)
- Water type classification: freshwater, saltwater, brackish, both
- Fish categories: game, food, aquarium, bait, sport, ornamental
- Physical traits: max length (cm), max weight (kg), color description
- Fishing data: fight rating (1-10), world records, best bait, recommended methods
- Aquarium data: min tank size (liters), temperature range, pH range, care level, temperament
- Cuisine: taste description, mercury level, culinary preparation notes
- 15 fishing methods (fly fishing, trolling, etc.) with difficulty levels and required gear
- 40 notable water bodies (oceans, seas, lakes, rivers, reefs)
- 197 countries, 48 fishing regions, 1,200 seasonal fishing entries
- 78 aquarium compatibility pairs
- 80 glossary terms across 8 categories
- 20 educational guides in 5 series

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/fish/` — Fish species directory (paginated, filterable) (e.g. `/fish/`)
- `/fish/{slug}/` — Fish species detail with taxonomy, traits, fishing data (e.g. `/fish/rainbow-trout/`)
- `/orders/` — Taxonomic orders list (e.g. `/orders/`)
- `/order/{slug}/` — Order detail with families and species (e.g. `/order/perciformes/`)
- `/family/{slug}/` — Family detail with species list (e.g. `/family/salmonidae/`)
- `/countries/` — Countries with fish data (e.g. `/countries/`)
- `/country/{code}/` — Country fish profile (ISO alpha-2) (e.g. `/country/us/`)
- `/methods/` — Fishing methods list (e.g. `/methods/`)
- `/method/{slug}/` — Fishing method detail (e.g. `/method/fly-fishing/`)
- `/water-bodies/` — Notable water bodies (e.g. `/water-bodies/`)
- `/water-body/{slug}/` — Water body detail (e.g. `/water-body/pacific-ocean/`)
- `/seasons/` — Fishing seasons index (Region x Month) (e.g. `/seasons/`)
- `/seasons/{slug}/{month}/` — Seasonal fishing detail (e.g. `/seasons/florida/6/`)
- `/compatibility/` — Aquarium compatibility index (N²) (e.g. `/compatibility/`)
- `/compatibility/{slug1}/vs/{slug2}/` — Aquarium compatibility check (e.g. `/compatibility/neon-tetra/vs/betta/`)
- `/compare/` — Fish comparison tool (N²) (e.g. `/compare/`)
- `/compare/{slug1}/vs/{slug2}/` — Compare two fish species (e.g. `/compare/rainbow-trout/vs/brown-trout/`)
- `/glossary/` — Ichthyology glossary (80 terms) (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term definition (e.g. `/glossary/anadromous/`)
- `/guides/` — Educational fish guides (20) (e.g. `/guides/`)
- `/guides/series/{slug}/` — Guide series (e.g. `/guides/series/fishing-basics/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/freshwater-fishing-101/`)
- `/tools/` — Interactive ichthyology tools (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/tank-size-calculator/`)
- `/search/` — Search fish, glossary (e.g. `/search/?q=trout`)

## Browse Fish
- [All Fish (35,729)](https://fishfyi.com/fish/)
- [Taxonomic Orders (98)](https://fishfyi.com/orders/)
- [Countries (197)](https://fishfyi.com/countries/)
- [Fishing Methods (15)](https://fishfyi.com/methods/)
- [Water Bodies (40)](https://fishfyi.com/water-bodies/)
- [Fishing Seasons](https://fishfyi.com/seasons/)

## Aquarium
- [Aquarium Compatibility](https://fishfyi.com/compatibility/)
- [Fish Comparison](https://fishfyi.com/compare/)

## Guides & Education
- [All Guides (20)](https://fishfyi.com/guides/)

## Glossary
- [All Terms (80)](https://fishfyi.com/glossary/)

## Interactive Tools
- [All Tools](https://fishfyi.com/tools/)

## Feeds
- [Guides RSS](https://fishfyi.com/feeds/guides/rss/)
- [Guides Atom](https://fishfyi.com/feeds/guides/atom/)

## Embed Widget
- [FishFYI Widget Docs](https://widget.fishfyi.com)
- [fishfyi-embed on npm](https://www.npmjs.com/package/fishfyi-embed)
- [fishfyi-embed on GitHub](https://github.com/fyipedia/fishfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/fish/` | List all fish (paginated) |
| GET | `/api/v1/fish/{id}/` | Fish detail |
| GET | `/api/v1/orders/` | List taxonomic orders |
| GET | `/api/v1/orders/{id}/` | Order detail |
| GET | `/api/v1/families/` | List taxonomic families |
| GET | `/api/v1/families/{id}/` | Family detail |
| GET | `/api/v1/countries/` | List all countries |
| GET | `/api/v1/countries/{id}/` | Country detail |
| GET | `/api/v1/regions/` | Fishing regions |
| GET | `/api/v1/methods/` | Fishing methods |
| GET | `/api/v1/water-bodies/` | Water bodies |
| GET | `/api/v1/seasons/` | Fishing season entries |
| GET | `/api/v1/compatibility/` | Aquarium compatibility pairs |
| GET | `/api/v1/glossary-categories/` | Glossary categories |
| GET | `/api/v1/glossary/` | Glossary terms (paginated) |
| GET | `/api/v1/glossary/{id}/` | Glossary term detail |
| GET | `/api/v1/guide-series/` | Guide series |
| GET | `/api/v1/guides/` | Guide articles (paginated) |
| GET | `/api/v1/guides/{id}/` | Guide detail |
| GET | `/api/v1/tools/` | Interactive tools |
| GET | `/api/v1/faqs/` | FAQs |
| GET | `/api/v1/search/?q={query}` | Search across fish, glossary |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://fishfyi.com/api/v1/fish/?limit=5"
```

[API Docs](https://fishfyi.com/developers/)

## Developer Tools
- **PyPI**: `pip install fishfyi` — [fishfyi](https://pypi.org/project/fishfyi/) — Fish species API client and CLI
- **npm**: `npm install fishfyi` — [fishfyi](https://www.npmjs.com/package/fishfyi) — TypeScript fish data utilities
- **Embed Widget**: [fishfyi-embed](https://widget.fishfyi.com)

## Nature FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [SpeciesFYI](https://speciesfyi.com) — Species taxonomy, classification, biodiversity
- [BirdFYI](https://birdfyi.com) — 11,251 birds, orders, families, conservation
- [PlantFYI](https://plantfyi.com) — 379,774 plants, taxonomy, cultivation
- [DinoFYI](https://dinofyi.com) — 6,142 dinosaurs, paleontology, geological eras

## Images (CDN)

OG images for fish at https://cdn.fishfyi.com/og/
- https://cdn.fishfyi.com/og/homepage.png
- https://cdn.fishfyi.com/og/fish/rainbow-trout.png

## Full Index
- [Full content index](https://fishfyi.com/llms-full.txt)
- [XML Sitemap](https://fishfyi.com/sitemap.xml)