# GemFYI

> Comprehensive gemstone encyclopedia — gemstones with physical, optical, value, and cultural properties. Categories include precious, semi-precious, organic, and synthetic gems. Covers Mohs hardness, refractive index, color science, birthstones, origins, treatments, and jewelry suitability.

## Data Scope
- Gemstones with physical properties (Mohs hardness, specific gravity, crystal system, cleavage, luster)
- Optical properties (refractive index, birefringence, dispersion, pleochroism, fluorescence)
- Color data (primary color, color range, color cause, allochromatic vs idiochromatic)
- Value and market data (price tiers, price per carat ranges, value factors)
- Cultural data (birthstone months, zodiac signs, anniversary years, symbolism)
- Treatment information (common treatments, disclosure guidelines)
- Jewelry use data (durability rating, popular cuts, care instructions)
- Gem origins with quality tiers (legendary, premium, commercial)
- Gem comparisons (N² pages) with side-by-side analysis
- Glossary terms organized by gemology category
- Guides in series with full markdown content
- Interactive tools: comparator, property ranker, carat converter, price estimator, and more
- 15 languages supported with i18n

## 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).
- `/` — Homepage with featured gems and stats (e.g. `/`)
- `/gems/` — Browse all gemstones (e.g. `/gems/`)
- `/gems/{slug}/` — Gemstone detail page (e.g. `/gems/diamond/`)
- `/compare/` — Gem comparison index (e.g. `/compare/`)
- `/compare/{slug_a}-vs-{slug_b}/` — Gem comparison (e.g. `/compare/diamond-vs-moissanite/`)
- `/category/{slug}/` — Gem category (precious, semi-precious, etc.) (e.g. `/category/precious/`)
- `/colors/` — Browse gems by color (e.g. `/colors/`)
- `/colors/{color}/` — Gems of a specific color (e.g. `/colors/red/`)
- `/origins/` — Gemstone origins and mining regions (e.g. `/origins/`)
- `/origins/{slug}/` — Origin detail (e.g. `/origins/kashmir/`)
- `/birthstones/` — Birthstone guide by month (e.g. `/birthstones/`)
- `/birthstones/{month}/` — Birthstone for a month (e.g. `/birthstones/april/`)
- `/glossary/` — Gemology glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term (e.g. `/glossary/birefringence/`)
- `/guides/` — Gemstone guides (e.g. `/guides/`)
- `/guide/{slug}/` — Guide article (e.g. `/guide/diamond-buying-guide/`)
- `/tools/` — Interactive gemstone tools (e.g. `/tools/`)
- `/tool/{slug}/` — Tool page (e.g. `/tool/gem-comparator/`)
- `/gems/{slug}/buying-guide/` — Buying guide for a gem (e.g. `/gems/emerald/buying-guide/`)

## Browse Gems
- [All Gemstones](https://gemfyi.com/gems/)
- [By Category](https://gemfyi.com/category/precious/)
- [By Color](https://gemfyi.com/colors/)
- [Birthstones](https://gemfyi.com/birthstones/)
- [Origins](https://gemfyi.com/origins/)
- [Gem Comparisons](https://gemfyi.com/compare/)

## Interactive Tools
- [Gem Comparator](https://gemfyi.com/tool/gem-comparator/)
- [Gem Property Ranker](https://gemfyi.com/tool/gem-property-ranker/)
- [Carat Weight Converter](https://gemfyi.com/tool/carat-weight-converter/)
- [Gemstone Price Estimator](https://gemfyi.com/tool/price-estimator/)
- [Ring Size Converter](https://gemfyi.com/tool/ring-size-guide/)
- [Brilliance & Fire Calculator](https://gemfyi.com/tool/brilliance-calculator/)
- [Specific Gravity Tester](https://gemfyi.com/tool/specific-gravity-tester/)
- [Gem Dimensions Estimator](https://gemfyi.com/tool/gem-dimensions-calculator/)

## Learn
- [Gemology Glossary](https://gemfyi.com/glossary/)
- [Guides](https://gemfyi.com/guides/)

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

## REST API

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

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/gems/` | List gemstones (DRF, paginated) |
| GET | `/api/v1/gems/{slug}/` | Gemstone detail |
| GET | `/api/v1/categories/` | Gem categories (DRF, paginated) |
| GET | `/api/v1/origins/` | Gem origins (DRF, paginated) |
| GET | `/api/v1/glossary/` | Glossary terms (DRF, paginated) |
| GET | `/api/v1/guides/` | Guides (DRF, paginated) |
| GET | `/api/v1/tools/` | Interactive tools (DRF, paginated) |
| GET | `/api/v1/faqs/` | FAQs (DRF, paginated) |
| GET | `/api/v1/search/?q={query}` | Unified search (DRF) |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://gemfyi.com/api/v1/gems/"
```

[API Docs](https://gemfyi.com/developers/) · [OpenAPI Spec](https://gemfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install gemfyi` — [gemfyi](https://pypi.org/project/gemfyi/) — Gemstone data, Mohs scale, optical properties
- **Embed Widget**: [gemfyi-embed](https://widget.gemfyi.com)

## Science FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [ChemFYI](https://chemfyi.com) — Periodic table, elements, compounds, reactions
- [AlloyFYI](https://alloyfyi.com) — Metal alloys, compositions, properties
- [StarFYI](https://starfyi.com) — Stars, constellations, exoplanets, deep-sky objects
- [MineralFYI](https://mineralfyi.com) — 6,215 minerals, crystal systems, Mohs hardness

## Images (CDN)

OG images for all entities at https://cdn.gemfyi.com/og/{type}/{slug}.png
- https://cdn.gemfyi.com/og/homepage.png

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