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.

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