Gemstone Recommendations API
Personalized gemstone recommendations based on Vedic astrology and birth chart analysis
Planetary Gemstones in Vedic Astrology
Gemstones (Ratna) play a crucial role in Vedic astrology for balancing planetary influences and enhancing positive energies.
Sun - Ruby (Manik)
Enhances leadership, vitality, and self-confidence
Moon - Pearl (Moti)
Improves emotional balance and mental peace
Mars - Red Coral (Moonga)
Boosts courage, energy, and physical strength
Mercury - Emerald (Panna)
Enhances intelligence, communication, and business success
Jupiter - Yellow Sapphire (Pukhraj)
Brings wisdom, prosperity, and spiritual growth
Saturn - Blue Sapphire (Neelam)
Provides stability, discipline, and protection from misfortunes
Rahu - Hessonite (Gomed)
Protects from evil influences and enhances spiritual awareness
Ketu - Cat's Eye (Lehsunia)
Brings spiritual enlightenment and removes obstacles
Venus - Diamond (Heera)
Enhances love, beauty, luxury, and artistic abilities
API Endpoints
Get Personalized Gemstone Recommendations
GET /v1/recommendations/gemstones
Personalized
Get gemstone recommendations based on your complete birth chart analysis
curl -X GET 'https://api.astro-fusion.com/v1/recommendations/gemstones?date=1990-06-15T14:30:00Z&latitude=28.6139&longitude=77.2090&timezone=5.5' \
-H 'Authorization: Bearer YOUR_API_KEY'
Get Zodiac-Based Gemstones
GET /v1/recommendations/gemstones/zodiac/:sign
Zodiac-based
Get gemstone recommendations based on sun sign/zodiac sign
curl -X GET 'https://api.astro-fusion.com/v1/recommendations/gemstones/zodiac/gemini' \
-H 'Authorization: Bearer YOUR_API_KEY'
Get Gemstone Details
GET /v1/recommendations/gemstones/info/:gemstone
Reference
Get detailed information about a specific gemstone
curl -X GET 'https://api.astro-fusion.com/v1/recommendations/gemstones/info/ruby' \
-H 'Authorization: Bearer YOUR_API_KEY'
Personalized Recommendations Response
Complete Analysis Response
{
"birthChart": {
"sunSign": "Gemini",
"moonSign": "Cancer",
"ascendant": "Leo",
"planetaryStrengths": {
"strong": ["Mercury", "Venus"],
"weak": ["Saturn", "Mars"],
"afflicted": ["Jupiter"]
}
},
"primaryGemstone": {
"name": "Emerald",
"planet": "Mercury",
"reason": "Strengthens Mercury which is your ruling planet",
"weight": "3-5 carats",
"quality": "Natural, untreated",
"certification": "GIA or equivalent"
},
"secondaryGemstones": [
{
"name": "Yellow Sapphire",
"planet": "Jupiter",
"reason": "Balances Jupiter which is afflicted in your chart",
"priority": "High"
},
{
"name": "Blue Sapphire",
"planet": "Saturn",
"reason": "Strengthens Saturn which is weak in your chart",
"priority": "Medium"
}
],
"wearingInstructions": {
"finger": "Little finger (left hand)",
"day": "Wednesday",
"time": "Morning (sunrise)",
"mantra": "ॐ बुधाय नमः (Om Budhay Namah)",
"prayer": "Pray to Lord Vishnu or Mercury before wearing"
},
"benefits": [
"Enhanced communication skills",
"Improved business success",
"Better academic performance",
"Stronger intuition"
],
"precautions": [
"Avoid wearing during sleep",
"Remove during bathing or swimming",
"Clean regularly with mild soap",
"Avoid contact with chemicals"
],
"alternativeGemstones": [
{
"name": "Peridot",
"reason": "Affordable alternative to Emerald",
"effectiveness": "70% of Emerald"
}
]
}
Zodiac-Based Response
{
"zodiacSign": "Gemini",
"element": "Air",
"rulingPlanet": "Mercury",
"primaryGemstone": {
"name": "Emerald",
"planet": "Mercury",
"properties": "Intelligence, communication, adaptability",
"benefits": [
"Enhanced communication skills",
"Better learning ability",
"Improved business acumen",
"Stronger nervous system"
]
},
"supportingGemstones": [
{
"name": "Agate",
"purpose": "Grounding and stability",
"whenToUse": "During stressful periods"
},
{
"name": "Aquamarine",
"purpose": "Calming and clear thinking",
"whenToUse": "For mental clarity"
}
],
"wearingGuide": {
"bestDay": "Wednesday",
"bestTime": "Morning",
"finger": "Little finger",
"metal": "Gold or silver",
"mantra": "ॐ बुधाय नमः"
}
}
Gemstone Wearing Guidelines
👐 Finger Selection
- Thumb: For willpower and courage
- Index: For leadership and ambition
- Middle: For patience and wisdom
- Ring: For creativity and relationships
- Little: For communication and intellect
📅 Auspicious Days
- Sunday: Ruby, Red Coral
- Monday: Pearl, Moonstone
- Tuesday: Red Coral, Cat's Eye
- Wednesday: Emerald, Green Jade
- Thursday: Yellow Sapphire, Citrine
- Friday: Diamond, Amethyst
- Saturday: Blue Sapphire, Lapis Lazuli
🕐 Auspicious Times
- Sunrise: Most powerful time
- Morning (6-12): Good for all gemstones
- Afternoon: Avoid for hot gemstones
- Evening: Good for cold gemstones
- Night: Generally avoid wearing
🔧 Metal Selection
- Gold: Enhances gemstone power
- Silver: Good for most gemstones
- Panchdhatu: Traditional five-metal alloy
- Copper: For grounding (rarely used)
Mantras and Rituals
Ruby (Manik) Mantra
Chant 108 times before wearing
Pearl (Moti) Mantra
Chant during moonrise
Emerald (Panna) Mantra
Chant 16,000 times for full activation
Diamond (Heera) Mantra
Chant 16,000 times
Gemstone Wearing Ceremony
- Purification: Clean the gemstone with Gangajal (holy water)
- Prana Pratishta: Energize with appropriate mantra chanting
- Wearing: Wear on auspicious day and time
- Activation: Keep in sunlight/moonlight for 24 hours
- Maintenance: Clean weekly and recharge monthly
JavaScript Integration Example
class GemstoneRecommender {
constructor(apiKey) {
this.apiKey = apiKey;
this.baseURL = 'https://api.astro-fusion.com/v1';
}
async getPersonalizedRecommendations(birthData) {
const params = new URLSearchParams({
date: birthData.date,
latitude: birthData.latitude,
longitude: birthData.longitude,
timezone: birthData.timezone || 5.5
});
const response = await fetch(\`\${this.baseURL}/recommendations/gemstones?\${params}\`, {
headers: {
'Authorization': \`Bearer \${this.apiKey}\`,
'Content-Type': 'application/json'
}
});
return await response.json();
}
async getZodiacGemstones(zodiacSign) {
const response = await fetch(\`\${this.baseURL}/recommendations/gemstones/zodiac/\${zodiacSign}\`, {
headers: {
'Authorization': \`Bearer \${this.apiKey}\`,
'Content-Type': 'application/json'
}
});
return await response.json();
}
displayRecommendations(recommendations) {
const container = document.getElementById('gemstone-results');
const primaryGem = recommendations.primaryGemstone;
const html = \`
<div class="gemstone-result">
<h3>Primary Gemstone: \${primaryGem.name}</h3>
<p><strong>Planet:</strong> \${primaryGem.planet}</p>
<p><strong>Reason:</strong> \${primaryGem.reason}</p>
<p><strong>Weight:</strong> \${primaryGem.weight}</p>
<h4>Wearing Instructions</h4>
<ul>
<li><strong>Finger:</strong> \${recommendations.wearingInstructions.finger}</li>
<li><strong>Day:</strong> \${recommendations.wearingInstructions.day}</li>
<li><strong>Time:</strong> \${recommendations.wearingInstructions.time}</li>
<li><strong>Mantra:</strong> \${recommendations.wearingInstructions.mantra}</li>
</ul>
<h4>Benefits</h4>
<ul>
\${recommendations.benefits.map(benefit => \`<li>\${benefit}</li>\`).join('')}
</ul>
</div>
\`;
container.innerHTML = html;
}
}
// Usage
const recommender = new GemstoneRecommender('YOUR_API_KEY');
// Get recommendations for a birth chart
const birthData = {
date: '1990-06-15T14:30:00Z',
latitude: 28.6139,
longitude: 77.2090,
timezone: 5.5
};
recommender.getPersonalizedRecommendations(birthData)
.then(recommendations => {
recommender.displayRecommendations(recommendations);
})
.catch(error => {
console.error('Error getting recommendations:', error);
});