Developer Documentation
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.
- 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.)
Quick Start
curl -s "https://speciesfyi.com/api/v1/species/?limit=5"
API Endpoints
| 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 |
URL Patterns
Use these patterns to construct URLs programmatically:
/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)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
SDK Packages
PyPI
pip install speciesfyi
Species taxonomy API client and CLI (v0.1.1)
npm
npm install speciesfyi
TypeScript species data utilities (v0.1.0)
Embed Widget
Embed data cards on your site:
https://widget.speciesfyi.com
npm install speciesfyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.