# DinoFYI

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

## Data Scope
- 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

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/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/antlers-formation-texas/`)
- `/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-morphology/`)
- `/glossary/{slug}/` — Glossary term definition (e.g. `/glossary/adaptive-radiation/`)
- `/guides/` — Educational dinosaur guides (35) (e.g. `/guides/`)
- `/guides/series/{slug}/` — Guide series (e.g. `/guides/series/dinosaur-basics/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/citizen-science-and-amateur-paleontology/`)
- `/tools/` — Interactive paleontology tools (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/dino-size-comparator/`)
- `/nearby/` — Dinosaur discovery sites near me (e.g. `/nearby/`)
- `/nearby/{slug}/` — Nearby fossil sites within 500 km (e.g. `/nearby/antlers-formation-texas/`)
- `/search/` — Search dinosaurs, glossary (e.g. `/search/?q=trex`)

## Browse Dinosaurs
- [All Dinosaurs (6,142)](https://dinofyi.com/dinosaurs/)
- [Geologic Periods (15)](https://dinofyi.com/periods/)
- [Classifications (15)](https://dinofyi.com/classifications/)
- [Countries (198)](https://dinofyi.com/countries/)
- [Discovery Sites](https://dinofyi.com/sites/)

## Guides & Education
- [All Guides (35)](https://dinofyi.com/guides/)

## Glossary
- [All Terms (159)](https://dinofyi.com/glossary/)

## Interactive Tools
- [All Tools](https://dinofyi.com/tools/)
- [Dinosaur Comparison](https://dinofyi.com/compare/)

## Location
- [Discovery Sites Near Me](https://dinofyi.com/nearby/)

## Embed Widget
- [DinoFYI Widget Docs](https://widget.dinofyi.com)
- [dinofyi-embed on npm](https://www.npmjs.com/package/dinofyi-embed)
- [dinofyi-embed on GitHub](https://github.com/fyipedia/dinofyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

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

```bash
curl -s "https://dinofyi.com/api/v1/dinosaurs/?limit=5"
```

[API Docs](https://dinofyi.com/developers/)

## Developer Tools
- **PyPI**: `pip install dinofyi` — [dinofyi](https://pypi.org/project/dinofyi/) — Dinosaur species API client and CLI
- **npm**: `npm install dinofyi` — [dinofyi](https://www.npmjs.com/package/dinofyi) — TypeScript dinosaur data utilities
- **Embed Widget**: [dinofyi-embed](https://widget.dinofyi.com)

## Nature FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [SpeciesFYI](https://speciesfyi.com) — Species taxonomy, classification, biodiversity
- [BirdFYI](https://birdfyi.com) — 11,251 birds, orders, families, conservation
- [FishFYI](https://fishfyi.com) — Fish species, marine biology, habitats
- [PlantFYI](https://plantfyi.com) — 379,774 plants, taxonomy, cultivation

## Images (CDN)

OG images for dinosaurs at https://cdn.dinofyi.com/og/
- https://cdn.dinofyi.com/og/homepage.png
- https://cdn.dinofyi.com/og/dinosaurs/tyrannosaurus-rex.png

## Full Index
- [Full content index](https://dinofyi.com/llms-full.txt)
- [XML Sitemap](https://dinofyi.com/sitemap.xml)