Crystals and Healing Stones API reference

Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and Rose Quartz to Moldavite and Selenite, each with its spiritual, emotional, and physical properties. Filter by chakra (Root through Crown), zodiac sign, or element, search by keyword, browse birthstones by month, discover crystal pairings, and get random or daily crystal picks. Includes Mohs hardness, numerological vibration, and planetary associations per stone. Built for wellness apps, crystal shops, chakra-balancing tools, astrology integrations, and AI spiritual advisors. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

12 endpoints. Product page. Typed SDKs in six languages carry every operation below.

Your API keyKept in this tab only. Without a key, a small daily allowance still answers every request below.

Crystals by zodiac sign - Zodiac birthstone API

GET /api/v2/crystals/zodiac/{sign}

Get healing crystals and gemstones associated with a specific zodiac sign. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports all 12 zodiac signs from Aries through Pisces. Perfect for personalized crystal recommendations based on astrological birth chart data.

Parameters

Parameter	Type	Description
`sign` required path	string enum	Zodiac sign name, case-insensitive (e.g., pisces, Pisces, PISCES all work). Valid: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.
`limit` query	integer	Maximum items to return per page. Range: 1-30, default 20. Default `20`.
`offset` query	integer	Number of items to skip for pagination. Default 0. Default `0`.

curl

curl "https://roxyapi.com/api/v2/crystals/zodiac/pisces" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`sign` required	string	The zodiac sign that was queried.
`total` required	number	Total number of crystals associated with this zodiac sign.
`limit` required	number	Maximum crystals returned per page.
`offset` required	number	Number of crystals skipped.
`crystals` required	array of object	Crystal summaries for this zodiac sign. Call /crystals/{id} for full healing properties.
`crystals[].name` required	string	Crystal display name.
`crystals[].id` required	string	URL-safe crystal identifier for detail lookup.
`crystals[].imageUrl` required	stringnull	URL to crystal photograph for visual identification.
`crystals[].colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable.

Example response

{
  "sign": "Pisces",
  "total": 9,
  "limit": 20,
  "offset": 0,
  "crystals": [
    {
      "name": "Amethyst",
      "id": "amethyst",
      "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
      "colors": [
        "violet",
        "purple"
      ]
    }
  ]
}

Crystals by chakra - Chakra healing stones API

GET /api/v2/crystals/chakra/{chakra}

Get healing crystals and gemstones that resonate with a specific chakra energy center. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports all 7 primary chakras: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, and Crown. Essential for crystal grid building, chakra balancing, and energy healing applications.

Parameters

Parameter	Type	Description
`chakra` required path	string enum	Chakra name, case-insensitive (e.g., heart, Heart, HEART all work). Valid: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.
`limit` query	integer	Maximum items to return per page. Range: 1-30, default 20. Default `20`.
`offset` query	integer	Number of items to skip for pagination. Default 0. Default `0`.

curl

curl "https://roxyapi.com/api/v2/crystals/chakra/Heart" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`chakra` required	string	The chakra energy center that was queried.
`total` required	number	Total number of crystals associated with this chakra.
`limit` required	number	Maximum crystals returned per page.
`offset` required	number	Number of crystals skipped.
`crystals` required	array of object	Crystal summaries for this chakra. Call /crystals/{id} for full healing properties.
`crystals[].name` required	string	Crystal display name.
`crystals[].id` required	string	URL-safe crystal identifier for detail lookup.
`crystals[].imageUrl` required	stringnull	URL to crystal photograph for visual identification.
`crystals[].colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable.

Example response

{
  "chakra": "Heart",
  "total": 33,
  "limit": 20,
  "offset": 0,
  "crystals": [
    {
      "name": "Amethyst",
      "id": "amethyst",
      "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
      "colors": [
        "violet",
        "purple"
      ]
    }
  ]
}

Crystals by element - Elemental crystal lookup API

GET /api/v2/crystals/element/{element}

Get healing crystals and gemstones associated with a specific natural element. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports five elements: Earth, Water, Fire, Air, and Storm. Essential for elemental crystal selection, nature-based healing, and element-themed crystal grid applications.

Parameters

Parameter	Type	Description
`element` required path	string enum	Element name, case-insensitive (e.g., water, Water, WATER all work). Valid: Earth, Water, Fire, Air, Storm.
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.
`limit` query	integer	Maximum items to return per page. Range: 1-30, default 20. Default `20`.
`offset` query	integer	Number of items to skip for pagination. Default 0. Default `0`.

curl

curl "https://roxyapi.com/api/v2/crystals/element/Water" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`element` required	string	The element that was queried.
`total` required	number	Total number of crystals associated with this element.
`limit` required	number	Maximum crystals returned per page.
`offset` required	number	Number of crystals skipped.
`crystals` required	array of object	Crystal summaries for this element. Call /crystals/{id} for full healing properties.
`crystals[].name` required	string	Crystal display name.
`crystals[].id` required	string	URL-safe crystal identifier for detail lookup.
`crystals[].imageUrl` required	stringnull	URL to crystal photograph for visual identification.
`crystals[].colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable.

Example response

{
  "element": "Water",
  "total": 29,
  "limit": 20,
  "offset": 0,
  "crystals": [
    {
      "name": "Amethyst",
      "id": "amethyst",
      "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
      "colors": [
        "violet",
        "purple"
      ]
    }
  ]
}

Birthstones by month - Birthstone lookup API

GET /api/v2/crystals/birthstone/{month}

Get the traditional birthstone crystals for a given birth month. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Based on GIA-authoritative birthstone assignments. Perfect for birthday gift recommendations, personalized crystal suggestions, and birthstone jewelry applications.

Parameters

Parameter	Type	Description
`month` required path	integer	Birth month as a number from 1 (January) to 12 (December).
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

curl

curl "https://roxyapi.com/api/v2/crystals/birthstone/2" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`month` required	number	The month number that was queried (1-12).
`monthName` required	string	Full name of the queried month.
`total` required	number	Number of birthstone crystals for this month.
`crystals` required	array of object	Birthstone crystals for this month. Call /crystals/{id} for full healing properties.
`crystals[].name` required	string	Crystal display name.
`crystals[].id` required	string	URL-safe crystal identifier for detail lookup.
`crystals[].imageUrl` required	stringnull	URL to crystal photograph for visual identification.
`crystals[].colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable.

Example response

{
  "month": 2,
  "monthName": "February",
  "total": 1,
  "crystals": [
    {
      "name": "Amethyst",
      "id": "amethyst",
      "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
      "colors": [
        "violet",
        "purple"
      ]
    }
  ]
}

Search crystals - Crystal search API

GET /api/v2/crystals/search

Search for healing crystals by keyword or name. Matches against crystal names, healing keywords, descriptions, and spiritual/emotional/physical meaning fields. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Useful for building crystal search bars, keyword-based recommendation features, and healing property lookups.

Parameters

Parameter	Type	Description
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.
`q` required query	string	Search query (2-50 characters). Matches against crystal names, keywords, descriptions, and meaning fields. Case-insensitive partial matching.
`limit` query	integer	Maximum items to return per page. Range: 1-50, default 20. Default `20`.
`offset` query	integer	Number of items to skip for pagination. Default 0. Default `0`.

curl

curl "https://roxyapi.com/api/v2/crystals/search?q=love" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`query` required	string	The search query that was used.
`total` required	number	Total number of crystals matching the query.
`limit` required	number	Maximum crystals returned per page.
`offset` required	number	Number of crystals skipped.
`crystals` required	array of object	Matching crystal summaries. Call /crystals/{id} for full healing properties.
`crystals[].name` required	string	Crystal display name.
`crystals[].id` required	string	URL-safe crystal identifier for detail lookup.
`crystals[].imageUrl` required	stringnull	URL to crystal photograph for visual identification.
`crystals[].colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable.

Example response

{
  "query": "love",
  "total": 32,
  "limit": 20,
  "offset": 0,
  "crystals": [
    {
      "name": "Amethyst",
      "id": "amethyst",
      "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
      "colors": [
        "violet",
        "purple"
      ]
    }
  ]
}

Crystal pairings - Crystal combination API

GET /api/v2/crystals/pairings/{id}

Get crystals that pair well with a given crystal for enhanced healing combinations. Returns the source crystal along with its recommended companion stones and their properties. Essential for crystal grid building, healing combination recommendations, and crystal shop cross-sell features.

Parameters

Parameter	Type	Description
`id` required path	string	URL-safe crystal identifier to find pairings for, case-insensitive (e.g., "amethyst", "Amethyst", "rose-quartz" all resolve).
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

curl

curl "https://roxyapi.com/api/v2/crystals/pairings/amethyst" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`crystal` required	string	The crystal identifier that pairings were requested for.
`name` required	string	Display name of the source crystal.
`count` required	number	Number of recommended crystal pairings.
`pairings` required	array of object	Crystals recommended for use alongside the source crystal for synergistic healing.
`pairings[].name` required	string	Paired crystal display name.
`pairings[].id` required	string	URL-safe identifier for the paired crystal.
`pairings[].imageUrl` required	stringnull	URL to paired crystal photograph.
`pairings[].description` required	string	Brief overview of the paired crystal.
`pairings[].chakras` required	array of string	Chakra associations for the paired crystal.
`pairings[].keywords` required	array of string	Healing property keywords for the paired crystal. Null when keyword data is unavailable.

Example response

{
  "crystal": "amethyst",
  "name": "Amethyst",
  "count": 5,
  "pairings": [
    {
      "name": "Citrine",
      "id": "citrine",
      "imageUrl": "https://roxyapi.com/img/crystals/citrine.jpg",
      "description": "To manifest your dreams, you first need to know what they are. By activating both your imagination and your will, citrine helps you clearly envision what you want, and then gives you the persistence to see it through.",
      "chakras": [
        "Sacral",
        "Solar Plexus"
      ],
      "keywords": [
        "Happiness",
        "Prosperity"
      ]
    }
  ]
}

Daily crystal - Crystal of the day API

POST /api/v2/crystals/daily

Get the crystal of the day as a discovery teaser. Returns a deterministic crystal based on the current date (or a provided seed date), ensuring all users see the same crystal for any given day. Use the /crystals/{id} detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for daily guidance features, push notifications, wellness app widgets, and crystal journal integrations.

Parameters

Parameter	Type	Description
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

Request body

Field	Type	Description
`seed`	string	Optional seed for reproducible readings. Same seed + same date = same crystal every time. Pass any unique identifier (userId, email hash, session token). Omit for anonymous daily readings.
`date`	string (date)	Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones.

curl

curl -X POST "https://roxyapi.com/api/v2/crystals/daily" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":"user123","date":"2026-03-06"}'

Response fields

Field	Type	Description
`date` required	string	The date used for crystal selection (UTC).
`seed` required	string	Computed seed used for this reading. Same seed always produces the same crystal.
`name` required	string	Display name of the crystal selected for this date.
`id` required	string	URL-safe identifier. Call /crystals/{id} for full healing properties.
`imageUrl` required	stringnull	URL to crystal photograph. Use for daily crystal card display and visual features.
`description` required	string	Overview of the crystal covering primary healing purpose and benefits.
`chakras` required	array of string	Chakra energy centers this crystal resonates with for energy healing practice.
`zodiacSigns` required	array of string	Zodiac signs this crystal is traditionally associated with. Null when zodiac data is unavailable.
`affirmation` required	string	Positive affirmation aligned with the selected crystal. Use for daily affirmation features and meditation guidance.

Example response

{
  "date": "2026-03-05",
  "seed": "user123-2026-03-05",
  "name": "Rose Quartz",
  "id": "rose-quartz",
  "imageUrl": "https://roxyapi.com/img/crystals/rose-quartz.jpg",
  "description": "Rose quartz is the classic stone of love. It helps dissolve old hurts and open the heart to trust in love and have faith in the benevolence of the Universe.",
  "chakras": [
    "Heart"
  ],
  "zodiacSigns": [
    "Taurus",
    "Libra"
  ],
  "affirmation": "I am aligned with the energy of unconditional love."
}

Random crystal - Crystal discovery API

GET /api/v2/crystals/random

Get a randomly selected healing crystal as a discovery teaser. Returns a different crystal on each request (non-deterministic). Use the /crystals/{id} detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for crystal discovery features, surprise crystal picks, crystal roulette games, and exploration widgets. For a deterministic daily crystal that is the same for all users on a given date, use the /daily endpoint instead.

Parameters

Parameter	Type	Description
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

curl

curl "https://roxyapi.com/api/v2/crystals/random" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`name` required	string	Display name of the randomly selected crystal.
`id` required	string	URL-safe identifier. Call /crystals/{id} for full healing properties.
`imageUrl` required	stringnull	URL to crystal photograph for visual display.
`description` required	string	Overview of the crystal covering primary healing purpose and benefits.
`chakras` required	array of string	Chakra energy centers this crystal resonates with.
`zodiacSigns` required	array of string	Zodiac signs this crystal is traditionally associated with. Null when zodiac data is unavailable.
`affirmation` required	string	Positive affirmation aligned with the selected crystal energy.

Example response

{
  "name": "Citrine",
  "id": "citrine",
  "imageUrl": "https://roxyapi.com/img/crystals/citrine.jpg",
  "description": "To manifest your dreams, you first need to know what they are. By activating both your imagination and your will, citrine helps you clearly envision what you want, and then gives you the persistence to see it through.",
  "chakras": [
    "Sacral",
    "Solar Plexus"
  ],
  "zodiacSigns": [
    "Aries",
    "Gemini"
  ],
  "affirmation": "I am aligned with the energy of happiness."
}

List crystal colors - Crystal color filter API

GET /api/v2/crystals/colors

List all unique crystal colors available in the database. Use these values with the color filter on GET /crystals to find crystals by color. Essential reference endpoint for building color-based browsing of healing stones, visual crystal pickers, and filtering UI. The values are filter identifiers and stay in English under every lang, so a translated picker still submits a color the filter accepts.

Parameters

Parameter	Type	Description
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

curl

curl "https://roxyapi.com/api/v2/crystals/colors" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`count` required	number	Total number of unique color values in the database.
`colors` required	array of string	Alphabetically sorted list of all unique crystal colors. Pass any value to the color filter on GET /crystals.

Example response

{
  "count": 92,
  "colors": [
    "apple green",
    "azure blue"
  ]
}

List crystal planets - Planetary ruler filter API

GET /api/v2/crystals/planets

List all unique planetary associations available in the database. Use these values with the planet filter on GET /crystals to find crystals by ruling planet. Essential reference endpoint for astrology app builders who want to recommend crystals based on planetary placements in a birth chart. The values are filter identifiers and stay in English under every lang, so a translated picker still submits a planet the filter accepts.

Parameters

Parameter	Type	Description
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

curl

curl "https://roxyapi.com/api/v2/crystals/planets" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`count` required	number	Total number of unique planetary values in the database.
`planets` required	array of string	Alphabetically sorted list of all unique planetary associations. Pass any value to the planet filter on GET /crystals.

Example response

{
  "count": 13,
  "planets": [
    "Earth",
    "Jupiter"
  ]
}

List all crystals - Crystal healing database API

GET /api/v2/crystals

Retrieve healing crystals and gemstones with pagination. Supports optional filtering by chakra, zodiac sign, element, color, or planet. Returns minimal summary fields per crystal. Use the detail endpoint for full healing properties. Perfect for building crystal explorer apps, healing stone guides, and personalized crystal recommendation engines.

Parameters

Parameter	Type	Description
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.
`chakra` query	string enum	Filter by chakra association, case-insensitive. Valid values: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.
`zodiac` query	string enum	Filter by zodiac sign, case-insensitive. Valid values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.
`element` query	string enum	Filter by elemental association, case-insensitive. Valid values: Earth, Water, Fire, Air, Storm.
`color` query	string	Filter by crystal color (partial match, case-insensitive). E.g., "pink", "green", "blue", "purple". Use GET /colors for valid values.
`planet` query	string	Filter by planetary association (partial match, case-insensitive). E.g., "Venus", "Moon", "Jupiter". Use GET /planets for valid values.
`limit` query	integer	Maximum items to return per page. Range: 1-100, default 20. Default `20`.
`offset` query	integer	Number of items to skip for pagination. Default 0. Default `0`.

curl

curl "https://roxyapi.com/api/v2/crystals" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`total` required	number	Total number of crystals matching the filter criteria.
`limit` required	number	Maximum crystals returned per page.
`offset` required	number	Number of crystals skipped.
`crystals` required	array of object	Crystal summaries for the current page.
`crystals[].name` required	string	Crystal display name.
`crystals[].id` required	string	URL-safe crystal identifier for detail lookup.
`crystals[].imageUrl` required	stringnull	URL to crystal photograph for visual identification.
`crystals[].colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable.
`crystals[].chakras` required	array of string	Chakra energy centers this crystal resonates with. One of: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.

Example response

{
  "total": 91,
  "limit": 20,
  "offset": 0,
  "crystals": [
    {
      "name": "Amethyst",
      "id": "amethyst",
      "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
      "colors": [
        "violet",
        "purple"
      ],
      "chakras": [
        "Third Eye",
        "Crown"
      ]
    }
  ]
}

Get crystal by id - Crystal healing properties API

GET /api/v2/crystals/{id}

Get complete healing properties and metaphysical data for a specific crystal or gemstone. Returns spiritual, emotional, and physical healing interpretations along with chakra associations, zodiac connections, elemental properties, and crystal pairing recommendations. Authoritative interpretations covering all major healing crystals.

Parameters

Parameter	Type	Description
`id` required path	string	URL-safe crystal identifier, case-insensitive (e.g., "amethyst", "Amethyst", "rose-quartz" all resolve). Must match an entry in the database.
`lang` query	string enum	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default `en`.

curl

curl "https://roxyapi.com/api/v2/crystals/amethyst" \
  -H "X-API-Key: YOUR_KEY"

Response fields

Field	Type	Description
`name` required	string	Display name of the crystal or healing stone.
`id` required	string	URL-safe identifier for the crystal.
`imageUrl` required	stringnull	URL to a high-quality crystal photograph. Use for visual crystal guides, product listings, and crystal identification features.
`description` required	string	Overview of the crystal covering its primary healing purpose, spiritual significance, and key benefits.
`meaning` required	object	Detailed healing interpretations across three areas: spiritual and metaphysical, emotional and psychological, and physical body associations.
`meaning.spiritual` required	stringnull	Spiritual and metaphysical healing properties including energy work, meditation benefits, and higher consciousness connections. Null when spiritual interpretation is unavailable.
`meaning.emotional` required	string	Emotional healing properties including stress relief, relationship support, and emotional balance benefits.
`meaning.physical` required	stringnull	Physical healing associations traditionally attributed to this crystal in crystal healing practice. Null when physical healing data is unavailable.
`chakras` required	array of string	Chakra energy centers this crystal resonates with. One of: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.
`zodiacSigns` required	array of string	Zodiac signs this crystal is traditionally associated with. Null when zodiac data is unavailable. Useful for personalized crystal recommendations based on birth chart.
`planet` required	stringnull	Ruling planet or celestial body associated with this crystal in astrological tradition. Null when planetary association is unavailable.
`elements` required	array of string	Elemental associations (Earth, Water, Fire, Air, Storm) connecting the crystal to natural forces and energy types. Null when elemental data is unavailable.
`colors` required	array of string	Primary colors of this crystal variety. Null when color data is unavailable. Useful for color-based crystal selection and filtering.
`hardness` required	number	Mohs hardness scale rating (1-10). Indicates durability for jewelry use. Quartz family is 7, Diamond is 10, Selenite is 2.

Show all fieldsShow fewer fields

Field	Type	Description
`numericalVibration` required	number	Numerological vibration number linking this crystal to numerology meanings. Connects crystal healing with numerology practice.
`keywords` required	array of string	Keywords capturing the core healing properties and spiritual themes of this crystal. The count varies by stone, from a single keyword up to twenty. Null when keyword data is unavailable.
`birthMonth` required	numbernull	Birth month (1-12) if this crystal is a traditional birthstone. Null if not a birthstone. January is 1, December is 12.
`affirmation` required	string	Positive affirmation aligned with this crystal energy. Use for meditation, journaling, or daily affirmation features.
`pairsWith` required	array of string	Crystal identifiers that pair well with this stone for enhanced healing combinations. Use for crystal grid and pairing recommendations.

Example response

{
  "name": "Amethyst",
  "id": "amethyst",
  "imageUrl": "https://roxyapi.com/img/crystals/amethyst.jpg",
  "description": "Amethyst is a powerful purple quartz prized for protection, intuition, and spiritual growth. It is used for breaking bad habits, deepening meditation, and connecting with higher consciousness.",
  "meaning": {
    "spiritual": "Amethyst is thought to provide a protective shield against negative energies, transmuting them into loving, positive vibrations. It is also traditionally associated with clarity of thought, intuition, and inspiration.",
    "emotional": "Its calming energy supports emotional balance, encourages spiritual awareness, and promotes mindfulness. It encourages mental focus, memory, motivation, and dream recall, while assisting in maintaining inner calm and spiritual wisdom.",
    "physical": "Amethyst is traditionally believed to support overall vitality and holistic well-being. Crystal enthusiasts associate its energy with enhancing hormone balance, tuning the endocrine system, and strengthening the immune system."
  },
  "chakras": [
    "Third Eye",
    "Crown"
  ],
  "zodiacSigns": [
    "Virgo",
    "Sagittarius"
  ],
  "planet": "Jupiter",
  "elements": [
    "Air",
    "Water"
  ],
  "colors": [
    "violet",
    "purple"
  ],
  "hardness": 7,
  "numericalVibration": 3,
  "keywords": [
    "Nobility",
    "Spiritual Awareness"
  ],
  "birthMonth": 2,
  "affirmation": "I am filled with nobility.",
  "pairsWith": [
    "citrine",
    "rose-quartz"
  ]
}

Crystals and Healing Stones API reference

Crystals by zodiac sign - Zodiac birthstone API

Parameters

Response fields

Try it

Crystals by chakra - Chakra healing stones API

Parameters

Response fields

Try it

Crystals by element - Elemental crystal lookup API

Parameters

Response fields

Try it

Birthstones by month - Birthstone lookup API

Parameters

Response fields

Try it

Search crystals - Crystal search API

Parameters

Response fields

Try it

Crystal pairings - Crystal combination API

Parameters

Response fields

Try it

Daily crystal - Crystal of the day API

Parameters

Request body

Response fields

Try it

Random crystal - Crystal discovery API

Parameters

Response fields

Try it

List crystal colors - Crystal color filter API

Parameters

Response fields

Try it

List crystal planets - Planetary ruler filter API

Parameters

Response fields

Try it

List all crystals - Crystal healing database API

Parameters

Response fields

Try it

Get crystal by id - Crystal healing properties API

Parameters

Response fields

Try it