Developer Documentation
Comprehensive dinosaur encyclopedia. 6,142 dinosaur species, 15 classifications (clades), 15 geologic periods, 198 countries, 33 comparisons, 159 glossary terms, 35 guides, and interactive paleontology tools in 15 languages.
- 6,142 dinosaur species with names, scientific names, diet, size data
- 15 dinosaur classifications/clades (e.g. Theropoda, Sauropoda) with hierarchical parent-child relationships
- 15 geologic periods with era, start/end (millions of years ago), and species counts
- Diet types: herbivore, carnivore, omnivore, piscivore, insectivore
- Size data: length (m), weight (kg), height (m)
- Discovery data: year, location, named by
- 198 countries with discovery counts
- Discovery sites with geological formation names, coordinates, notable dinosaurs
- 33 pre-computed dinosaur comparisons
- External IDs: Paleobiology Database ID (PBDB), Wikidata QID
- 159 glossary terms across 10 categories (anatomy, stratigraphy, etc.)
- 35 educational guides in 7 series
Quick Start
curl -s "https://dinofyi.com/api/v1/dinosaurs/?limit=5"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/dinosaurs/ | List all dinosaurs (paginated) |
| GET | /api/v1/dinosaurs/{id}/ | Dinosaur detail |
| GET | /api/v1/periods/ | List geologic periods |
| GET | /api/v1/periods/{id}/ | Period detail |
| GET | /api/v1/classifications/ | List dinosaur clades |
| GET | /api/v1/classifications/{id}/ | Classification detail |
| GET | /api/v1/countries/ | List all countries |
| GET | /api/v1/countries/{id}/ | Country detail |
| GET | /api/v1/sites/ | Discovery sites |
| GET | /api/v1/sites/{id}/ | Discovery site detail |
| GET | /api/v1/comparisons/ | Dinosaur 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 dinosaurs, glossary |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/dinosaurs/
Dinosaur species directory (paginated, filterable) (e.g. /dinosaurs/)
/dinosaur/{slug}/
Dinosaur species detail with taxonomy, size, discovery (e.g. /dinosaur/tyrannosaurus-rex/)
/periods/
Geologic time periods list (e.g. /periods/)
/period/{slug}/
Period detail with dinosaurs (e.g. /period/cretaceous-late/)
/classifications/
Dinosaur clades/classifications (e.g. /classifications/)
/classification/{slug}/
Classification detail with species (e.g. /classification/theropoda/)
/countries/
Countries with dinosaur discoveries (e.g. /countries/)
/country/{code}/
Country discovery profile (ISO alpha-2) (e.g. /country/us/)
/sites/
Notable discovery sites (e.g. /sites/)
/site/{slug}/
Discovery site detail (e.g. /site/hell-creek-formation/)
/compare/
Dinosaur comparison tool (N²) (e.g. /compare/)
/compare/{slug1}/vs/{slug2}/
Compare two dinosaurs (e.g. /compare/tyrannosaurus-rex/vs/velociraptor/)
/glossary/
Paleontology glossary (159 terms) (e.g. /glossary/)
/glossary/category/{slug}/
Glossary category (e.g. /glossary/category/anatomy/)
/glossary/{slug}/
Glossary term definition (e.g. /glossary/fossil/)
/guides/
Educational dinosaur guides (35) (e.g. /guides/)
/guides/series/{slug}/
Guide series (e.g. /guides/series/paleontology-basics/)
/guide/{slug}/
Guide article (e.g. /guide/mesozoic-era-overview/)
/tools/
Interactive paleontology tools (e.g. /tools/)
/tool/{slug}/
Tool page (e.g. /tool/dino-size-comparison/)
/search/
Search dinosaurs, glossary (e.g. /search/?q=trex)
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 dinofyi
Dinosaur species API client and CLI
npm
npm install dinofyi
TypeScript dinosaur data utilities
Embed Widget
Embed data cards on your site:
https://widget.dinofyi.com
npm install dinofyi-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.