# SpeciesFYI

> Species taxonomy and biodiversity database. 49,112 species, 17,982 taxa across 7 Linnaean ranks (9 kingdoms, 89 phyla, 210 classes, 774 orders, 2,954 families, 13,946 genera), 197 countries, 846 ecoregions, 18 habitats, 227 glossary terms, 150 guides, and interactive ecology tools in 15 languages.

## Data Scope
- 49,112 species with scientific names, common names, conservation status (IUCN Red List)
- 17,982 taxa in Linnaean hierarchy: 9 kingdoms, 89 phyla, 210 classes, 774 orders, 2,954 families, 13,946 genera
- Conservation status breakdown: 22,018 LC, 3,228 VU, 3,000 NT, 2,609 EN, 1,593 CR, 590 EX, 34 EW, 1,874 DD
- 197 countries with biodiversity profiles, continent/region classification, ISO 3166-1 codes
- 846 WWF terrestrial ecoregions with biome and biogeographic realm data
- 18 IUCN habitat types
- 100 food web / trophic relationship records
- 120 field guides for wildlife observation
- 54 biology discovery milestones
- 227 glossary terms across 15 categories (ecology, evolution, genetics, marine biology, etc.)
- 150 educational guides in 10 series (ecology, evolution, animal kingdom, plant world, marine, conservation, etc.)

## 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).
- `/species/` — Species directory (paginated) (e.g. `/species/`)
- `/species/{slug}/` — Species detail with taxonomy, conservation, distribution (e.g. `/species/african-elephant/`)
- `/taxon/{rank}/{slug}/` — Taxon detail (kingdom/phylum/class/order/family/genus) (e.g. `/taxon/class/mammalia/`)
- `/countries/` — Country list by biodiversity (e.g. `/countries/`)
- `/country/{code}/` — Country biodiversity profile (ISO alpha-2) (e.g. `/country/ke/`)
- `/habitats/` — IUCN habitat classification (e.g. `/habitats/`)
- `/habitat/{slug}/` — Habitat detail with species list (e.g. `/habitat/forest/`)
- `/ecoregions/` — WWF terrestrial ecoregions (e.g. `/ecoregions/`)
- `/ecoregion/{slug}/` — Ecoregion detail (e.g. `/ecoregion/borneo-lowland-rain-forests/`)
- `/food-webs/` — Trophic relationships and food chains (e.g. `/food-webs/`)
- `/food-web/{slug}/` — Food web detail (e.g. `/food-web/coral-reef-food-web/`)
- `/field-guides/` — Wildlife observation field guides (e.g. `/field-guides/`)
- `/field-guide/{slug}/` — Field guide detail (e.g. `/field-guide/birdwatching-basics/`)
- `/discoveries/` — Biology discovery milestones (e.g. `/discoveries/`)
- `/discovery/{slug}/` — Discovery detail (e.g. `/discovery/dna-structure/`)
- `/glossary/` — Biology glossary (227 terms) (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term definition (e.g. `/glossary/biodiversity/`)
- `/guides/` — Educational biology guides (150) (e.g. `/guides/`)
- `/guides/series/{slug}/` — Guide series (e.g. `/guides/series/ecology-fundamentals/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/understanding-biomes/`)
- `/compare/` — Species comparison tool (N²) (e.g. `/compare/`)
- `/compare/{slug1}/vs/{slug2}/` — Compare two species (e.g. `/compare/african-elephant/vs/blue-whale/`)
- `/wildlife/` — Country × Habitat wildlife index (e.g. `/wildlife/`)
- `/wildlife/{code}/{habitat_slug}/` — Wildlife by country and habitat (e.g. `/wildlife/ke/forest/`)
- `/tools/` — Interactive ecology tools (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/species-diversity-calculator/`)
- `/search/` — Search species, taxa, glossary (e.g. `/search/?q=elephant`)

## Browse Species & Taxonomy
- [All Species (49,112)](https://speciesfyi.com/species/)
- [Kingdom Animalia](https://speciesfyi.com/taxon/kingdom/animalia/)
- [Kingdom Plantae](https://speciesfyi.com/taxon/kingdom/plantae/)
- [Kingdom Fungi](https://speciesfyi.com/taxon/kingdom/fungi/)
- [Class Mammalia](https://speciesfyi.com/taxon/class/mammalia/)
- [Class Aves (Birds)](https://speciesfyi.com/taxon/class/aves/)
- [Class Reptilia](https://speciesfyi.com/taxon/class/reptilia/)
- [Class Amphibia](https://speciesfyi.com/taxon/class/amphibia/)
- [Class Actinopterygii (Ray-finned Fish)](https://speciesfyi.com/taxon/class/actinopterygii/)
- [Class Insecta](https://speciesfyi.com/taxon/class/insecta/)

## Conservation
- [Critically Endangered (1,593)](https://speciesfyi.com/species/?conservation=CR)
- [Endangered (2,609)](https://speciesfyi.com/species/?conservation=EN)
- [Vulnerable (3,228)](https://speciesfyi.com/species/?conservation=VU)
- [Near Threatened (3,000)](https://speciesfyi.com/species/?conservation=NT)
- [Extinct (590)](https://speciesfyi.com/species/?conservation=EX)

## Geography & Habitats
- [Countries (197)](https://speciesfyi.com/countries/)
- [Habitats (18)](https://speciesfyi.com/habitats/)
- [Ecoregions (846)](https://speciesfyi.com/ecoregions/)
- [Wildlife by Country & Habitat](https://speciesfyi.com/wildlife/)

## Ecology & Behavior
- [Food Webs (100)](https://speciesfyi.com/food-webs/)
- [Field Guides (120)](https://speciesfyi.com/field-guides/)
- [Biology Discoveries (54)](https://speciesfyi.com/discoveries/)

## Guides & Education
- [All Guides (150)](https://speciesfyi.com/guides/)
- [Ecology Fundamentals](https://speciesfyi.com/guides/series/ecology-fundamentals/)
- [Evolution & Origins of Life](https://speciesfyi.com/guides/series/evolution-origins-of-life/)
- [The Animal Kingdom](https://speciesfyi.com/guides/series/the-animal-kingdom/)
- [The Plant World](https://speciesfyi.com/guides/series/the-plant-world/)
- [Marine Ecosystems](https://speciesfyi.com/guides/series/marine-ecosystems/)
- [Conservation in Action](https://speciesfyi.com/guides/series/conservation-in-action/)
- [Genetics & Heredity](https://speciesfyi.com/guides/series/genetics-heredity/)
- [Animal Behavior & Communication](https://speciesfyi.com/guides/series/animal-behavior-communication/)
- [Global Biodiversity Hotspots](https://speciesfyi.com/guides/series/global-biodiversity-hotspots/)
- [Field Research Methods](https://speciesfyi.com/guides/series/field-research-methods/)

## Glossary
- [All Terms (227)](https://speciesfyi.com/glossary/)

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

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

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

## REST API

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

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/species/` | List all species (paginated) |
| GET | `/api/v1/species/{id}/` | Species detail |
| GET | `/api/v1/taxa/` | List all taxa (paginated) |
| GET | `/api/v1/taxa/{id}/` | Taxon detail |
| GET | `/api/v1/ranks/` | Taxonomic ranks (7 Linnaean levels) |
| GET | `/api/v1/countries/` | List all countries |
| GET | `/api/v1/countries/{id}/` | Country detail |
| GET | `/api/v1/glossary/` | Glossary terms (paginated) |
| GET | `/api/v1/glossary/{id}/` | Glossary term detail |
| GET | `/api/v1/glossary-categories/` | Glossary categories |
| GET | `/api/v1/guides/` | Guide articles (paginated) |
| GET | `/api/v1/guides/{id}/` | Guide detail |
| GET | `/api/v1/guide-series/` | Guide series |
| GET | `/api/v1/habitats/` | Habitat types |
| GET | `/api/v1/ecoregions/` | Ecoregions (paginated) |
| GET | `/api/v1/food-webs/` | Food web records |
| GET | `/api/v1/field-guides/` | Field guides |
| GET | `/api/v1/discoveries/` | Biology discoveries |
| GET | `/api/v1/faqs/` | FAQs |
| GET | `/api/v1/search/?q={query}` | Search across species, taxa, glossary |
| GET | `/api/v1/stats/` | Site statistics |

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

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

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

## Nature FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [BirdFYI](https://birdfyi.com) — 11,251 birds, orders, families, conservation
- [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 species and taxa at https://cdn.speciesfyi.com/og/
- https://cdn.speciesfyi.com/og/homepage.png
- https://cdn.speciesfyi.com/og/species/african-elephant.png

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