Developer Documentation
Comprehensive plant encyclopedia. 379,774 plant species, 734 families across 50 orders, 13 Koppen climate zones, 50 countries, 48 comparisons, 260 glossary terms, 35 guides, and interactive botany tools in 15 languages.
- 379,774 plant species with scientific names, common names, conservation status
- 734 taxonomic families in 50 orders (e.g. Rosales, Fabales, Poales)
- Growth forms: tree, shrub, herb, vine, grass, fern, moss, succulent
- USDA hardiness zones (1-13), bloom season, flower color, max height/spread
- Care requirements: sun (full/partial/shade), water (low/moderate/high), soil type
- Edibility: edible, inedible, toxic, medicinal — with medicinal uses
- Conservation: IUCN status (LC/NT/VU/EN/CR/EW/EX/DD/NE)
- External IDs: Wikidata QID, WFO ID
- 13 Koppen climate zones with temperature/precipitation data
- 50 countries with distribution data
- 48 pre-computed plant comparisons
- 260 glossary terms across 15 categories
- 35 educational guides in 7 series
Quick Start
curl -s "https://plantfyi.com/api/v1/plants/?limit=5"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/plants/ | List all plants (paginated) |
| GET | /api/v1/plants/{id}/ | Plant detail |
| GET | /api/v1/orders/ | List plant orders |
| GET | /api/v1/orders/{id}/ | Order detail |
| GET | /api/v1/families/ | List plant families |
| GET | /api/v1/families/{id}/ | Family detail |
| GET | /api/v1/countries/ | List all countries |
| GET | /api/v1/countries/{id}/ | Country detail |
| GET | /api/v1/climate-zones/ | Climate zones |
| GET | /api/v1/climate-zones/{id}/ | Climate zone detail |
| GET | /api/v1/distributions/ | Plant distribution records |
| GET | /api/v1/comparisons/ | Plant 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/faqs/ | FAQs |
| GET | /api/v1/search/?q={query} | Search across plants, glossary |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/plants/
Plant species directory (paginated, filterable) (e.g. /plants/)
/plant/{slug}/
Plant species detail with taxonomy, care, cultivation (e.g. /plant/rosa-gallica/)
/families/
Plant families list (e.g. /families/)
/family/{slug}/
Family detail with species list (e.g. /family/rosaceae/)
/orders/
Plant orders list (e.g. /orders/)
/order/{slug}/
Order detail with families (e.g. /order/rosales/)
/countries/
Countries with plant data (e.g. /countries/)
/country/{code}/
Country plant profile (ISO alpha-2) (e.g. /country/us/)
/climate-zones/
Koppen climate zones (13) (e.g. /climate-zones/)
/climate-zone/{slug}/
Climate zone detail (e.g. /climate-zone/tropical-rainforest/)
/compare/
Plant comparison tool (N²) (e.g. /compare/)
/compare/{slug1}/vs/{slug2}/
Compare two plant species (e.g. /compare/rosa-gallica/vs/rosa-canina/)
/glossary/
Botany glossary (260 terms) (e.g. /glossary/)
/glossary/{slug}/
Glossary term definition (e.g. /glossary/photosynthesis/)
/guide/
Educational plant guides (35) (e.g. /guide/)
/guide/{slug}/
Guide article (e.g. /guide/indoor-gardening-basics/)
/tools/
Interactive botany tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/hardiness-zone-finder/)
/search/
Search plants, glossary (e.g. /search/?q=rose)
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 plantfyi
Plant species API client and CLI
npm
npm install plantfyi
TypeScript plant data utilities
Embed Widget
Embed data cards on your site:
https://widget.plantfyi.com
npm install plantfyi-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.