Developer Platform

Access SpeciesFYI biodiversity data through our REST API, markdown endpoints, and feeds.

REST API Endpoints

All endpoints return JSON. Paginated with ?limit= and ?offset=. Use ?lang=ko for translated fields.

Endpoint Description Filters
/api/species/ List all species q, conservation_status, diet, lang
/api/species/{slug}/ Species detail lang
/api/taxa/ List all taxa rank, parent, lang
/api/taxa/{rank}/{slug}/ Taxon detail lang
/api/countries/ List all countries continent, lang
/api/countries/{code}/ Country detail lang
/api/glossary/ List glossary terms category, q, lang
/api/glossary/{slug}/ Glossary term detail lang
/api/guides/ List published guides series, lang
/api/guides/{slug}/ Guide detail lang
/api/habitats/ List habitats level
/api/ecoregions/ List ecoregions biome, realm
/api/food-webs/ List food webs type
/api/food-webs/{slug}/ Food web detail lang
/api/field-guides/ List field guides region, group, difficulty
/api/discoveries/ List discoveries category, year
/api/discoveries/{slug}/ Discovery detail lang
/api/search/ Search species q (required), lang, limit
/api/stats/ Database statistics
/api/languages/ Available languages
/api/schema/ OpenAPI 3.0 schema
/api/docs/ Swagger UI

Markdown Endpoints

Append .md to any page URL to get a markdown version. Useful for LLM context, documentation, and programmatic access.

# Species profile
curl https://speciesfyi.com/species/african-lion.md
# Guide article
curl https://speciesfyi.com/guide/understanding-biomes.md
# With language prefix
curl https://speciesfyi.com/ko/species/african-lion.md

Quick Start

curl

# List species
curl https://speciesfyi.com/api/species/
# Search
curl "https://speciesfyi.com/api/search/?q=elephant"
# Species detail (Korean)
curl "https://speciesfyi.com/api/species/african-lion/?lang=ko"
# Database stats
curl https://speciesfyi.com/api/stats/

Python

import httpx
resp = httpx.get("https://speciesfyi.com/api/species/",
    params={"conservation_status": "CR", "limit": 10})
species = resp.json()["results"]

Additional Resources