Detailed Gemstone Suggestions API

Detailed Gemstone Suggestions

Returns comprehensive, astrology-based gemstone recommendations personalized to an individual's birth chart. Unlike a basic gemstone lookup, this endpoint performs a full Vedic astrological analysis of the provided birth data and produces an in-depth report for each recommended gemstone.

What This API Does

This endpoint accepts a date, time, and geographic coordinates of birth, computes the individual's planetary positions using the specified Ayanamsha system, and maps those positions to traditional gemstone correspondences in Vedic astrology. It then returns a detailed profile for each recommended stone — covering its astrological rationale, benefits, wearing instructions, and contraindications.

Data Returned

The response includes, for each recommended gemstone:

• Gemstone identity — name, associated planet, and ruling house in the birth chart

• Astrological rationale — why this stone is recommended based on the individual's planetary configuration

• Benefits — expected effects on health, career, relationships, or spiritual growth

• Wearing instructions — recommended metal, finger, day of the week, and ritual for first wearing

• Contraindications — planets or chart configurations that may make the stone unsuitable or require caution

• Quality and weight guidance — minimum carat weight and quality criteria for astrological efficacy

Main Use Cases

• Astrology platforms and apps — powering personalized gemstone recommendation features for end users

• Jyotish (Vedic astrology) practitioners — generating detailed client reports without manual chart analysis

• E-commerce and gemstone retailers — offering astrologically personalized product recommendations at checkout or on product pages

• Wellness and holistic health apps — integrating gemstone therapy recommendations into broader wellness journeys

Key Functionality

• Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, allowing practitioners to use their preferred calculation standard

• Accepts precise birth time and location (latitude, longitude, timezone) for accurate planetary degree calculations

• Returns planet-specific reasoning for each recommendation, making the output suitable for direct use in client-facing reports

• Designed for localization — the Accept-Language header controls the language of descriptive content in the response

• Goes beyond simple sun-sign or moon-sign lookups by analyzing the full natal chart, including ascendant, house lords, and planetary strengths