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.

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 .md to 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.