Developer Documentation

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.

• 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

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

{
  "count": 636,
  "next": "https://example.com/api/v1/items/?page=2",
  "previous": null,
  "results": [
    {"slug": "example", "name": "Example Item", "...": "..."}
  ]
}