# BirdFYI

> Interactive bird encyclopedia. 11,251 bird species, 258 families across 40 orders, 15 habitats, 197 countries with regional presence data, 19,160 regional records, 74 glossary terms, 15 guides, and interactive ornithology tools in 15 languages.

## Data Scope
- 11,251 bird species with scientific names, common names, conservation status (IUCN Red List)
- 258 taxonomic families in 40 orders (e.g. Passeriformes, Accipitriformes)
- 15 habitat types (e.g. Forest, Wetland, Grassland)
- 197 countries with bird count, continent, ISO 3166-1 codes
- 19,160 regional presence records (bird x country with migratory status and seasonal data)
- 50 pre-computed bird comparisons
- Physical traits: body length (cm), wingspan (cm), weight (g), plumage, bill description
- Conservation: IUCN status (EX/EW/CR/EN/VU/NT/LC/DD/NE), population estimates and trends
- Behavior: diet, nesting, clutch size, song and call descriptions, Xeno-canto audio IDs
- 74 glossary terms across 8 categories
- 15 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).
- `/birds/` — Bird species directory (paginated, filterable) (e.g. `/birds/`)
- `/bird/{slug}/` — Bird species detail with taxonomy, traits, conservation (e.g. `/bird/bald-eagle/`)
- `/orders/` — Taxonomic orders list (e.g. `/orders/`)
- `/order/{slug}/` — Order detail with families and species (e.g. `/order/passeriformes/`)
- `/family/{slug}/` — Family detail with species list (e.g. `/family/corvidae/`)
- `/countries/` — Countries with bird data (e.g. `/countries/`)
- `/country/{code}/` — Country bird profile (ISO alpha-2) (e.g. `/country/us/`)
- `/habitats/` — Habitat types list (e.g. `/habitats/`)
- `/habitat/{slug}/` — Habitat detail with species (e.g. `/habitat/forest/`)
- `/regional/` — Regional presence index (Country x Season) (e.g. `/regional/`)
- `/regional/{code}/{season}/` — Regional detail (e.g. `/regional/us/spring/`)
- `/compare/` — Bird comparison tool (N²) (e.g. `/compare/`)
- `/compare/{slug1}/vs/{slug2}/` — Compare two bird species (e.g. `/compare/bald-eagle/vs/golden-eagle/`)
- `/glossary/` — Ornithology glossary (74 terms) (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term definition (e.g. `/glossary/migration/`)
- `/guides/` — Educational bird guides (15) (e.g. `/guides/`)
- `/guides/series/{slug}/` — Guide series (e.g. `/guides/series/birdwatching-basics/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/identifying-raptors/`)
- `/tools/` — Interactive ornithology tools (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/bird-size-comparison/`)
- `/search/` — Search birds, glossary (e.g. `/search/?q=eagle`)

## Browse Birds
- [All Birds (11,251)](https://birdfyi.com/birds/)
- [Taxonomic Orders (40)](https://birdfyi.com/orders/)
- [Countries (197)](https://birdfyi.com/countries/)
- [Habitats (15)](https://birdfyi.com/habitats/)
- [Regional Presence](https://birdfyi.com/regional/)

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

## Glossary
- [All Terms (74)](https://birdfyi.com/glossary/)

## Interactive Tools
- [All Tools](https://birdfyi.com/tools/)
- [Bird Comparison](https://birdfyi.com/compare/)

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

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

## REST API

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

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/birds/` | List all birds (paginated) |
| GET | `/api/v1/birds/{id}/` | Bird 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/habitats/` | List habitat types |
| GET | `/api/v1/habitats/{id}/` | Habitat detail |
| GET | `/api/v1/countries/` | List all countries |
| GET | `/api/v1/countries/{id}/` | Country detail |
| GET | `/api/v1/regional-presences/` | Regional presence records |
| GET | `/api/v1/comparisons/` | Bird comparisons |
| 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 birds, glossary |
| GET | `/api/v1/stats/` | Site statistics |

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

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

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

## Nature FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [SpeciesFYI](https://speciesfyi.com) — Species taxonomy, classification, biodiversity
- [FishFYI](https://fishfyi.com) — Fish species, marine biology, habitats
- [PlantFYI](https://plantfyi.com) — 379,774 plants, taxonomy, cultivation
- [DinoFYI](https://dinofyi.com) — 6,142 dinosaurs, paleontology, geological eras

## Images (CDN)

OG images for birds at https://cdn.birdfyi.com/og/
- https://cdn.birdfyi.com/og/homepage.png
- https://cdn.birdfyi.com/og/birds/bald-eagle.png

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