Crystals

Crystal recommendations

Recommend crystals based on zodiac sign, chakra, or intention keyword. At least one filter must be provided. Providing multiple filters returns crystals that match the most criteria first. Valid chakras: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown. Returns up to limit crystals (default 5, max 20).

post/v1/crystals/recommend

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/crystals/recommend
  • Auth: HTTP bearer

Request body

zodiac_signstring nullable

Western zodiac sign to filter by. Example: 'Taurus', 'Scorpio'.

chakrastring nullable

Chakra to filter by. One of: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.

intentionstring nullable

Intention keyword to match. Example: 'protection', 'love', 'abundance'.

limitinteger

Maximum number of recommendations to return.

Example request

{
  "zodiac_sign": "Taurus",
  "chakra": "Heart",
  "intention": "abundance"
}

Response

Successful Response

successboolean

True if the request succeeded

messagestring

Human-readable status message

Changes

No recorded changes to this operation across all 2 revisions of this API.