Crystals

Crystal healing maps gemstones to chakras, zodiac signs, and healing properties. Roxy has 80+ crystals with detailed spiritual, emotional, and physical meanings. Your users care about this for wellness apps, crystal recommendation features, and chakra balancing tools.

New to fetch()? The Western Astrology guide has an annotated example explaining every line of an API call.

What you can build

• Crystal recommendation engines — suggest crystals by zodiac, chakra, or intention
• Crystal encyclopedia apps — browse properties, meanings, and usage
• Wellness features — add crystal healing to any spiritual or health app
• Daily crystal widgets — daily crystal with affirmation

Which endpoints to call

Crystal detail

Look up any crystal by slug (e.g., "amethyst", "rose-quartz"):

const response = await fetch('https://roxyapi.com/api/v2/crystals/amethyst', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const crystal = await response.json();

Response (abbreviated):

{
  "name": "Amethyst",
  "slug": "amethyst",
  "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
  "description": "A powerful protective stone with a high spiritual vibration...",
  "meaning": {
    "spiritual": "Enhances meditation, intuition, and psychic abilities...",
    "emotional": "Calms the mind, relieves stress and anxiety...",
    "physical": "Supports the immune system, reduces headaches..."
  },
  "chakras": ["Third Eye", "Crown"],
  "zodiacSigns": ["Pisces", "Virgo", "Aquarius"],
  "planet": "Jupiter",
  "colors": ["Purple", "Violet"],
  "keywords": ["Protection", "Intuition", "Calm"],
  "affirmation": "I trust my intuition and embrace spiritual growth.",
  "pairsWith": ["Clear Quartz", "Rose Quartz"]
}

Which fields to show your users: name and imageUrl for the visual. description is the overview. meaning.spiritual, meaning.emotional, and meaning.physical are the three interpretation categories. chakras and zodiacSigns are great for filtering and recommendations. affirmation is a ready-made quote for daily features. pairsWith suggests complementary crystals.

Crystals by zodiac sign

Recommend crystals based on a user's zodiac sign:

const response = await fetch('https://roxyapi.com/api/v2/crystals/zodiac/Pisces', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
// data.sign — "Pisces"
// data.crystals — array of matching crystals

Crystals by chakra

Filter by chakra for wellness and meditation apps:

const response = await fetch('https://roxyapi.com/api/v2/crystals/chakra/Heart', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
// data.chakra — "Heart"
// data.crystals — array of heart chakra crystals

Daily crystal

A random crystal each day with affirmation:

const response = await fetch('https://roxyapi.com/api/v2/crystals/daily', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const daily = await response.json();
// daily.name, daily.imageUrl, daily.affirmation

Search and browse

Search by keyword or browse the full catalog:

// Search
const search = await fetch('https://roxyapi.com/api/v2/crystals/search?q=calm&limit=5', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
}).then(r => r.json());

// Browse all (paginated)
const all = await fetch('https://roxyapi.com/api/v2/crystals?limit=20&offset=0', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
}).then(r => r.json());

Full API reference

See all Crystals endpoints in the API Reference.