Gems · Rudraksha · Planetary Strength · Affiliate Revenue

Gem & Remedy Engine API
chart-based gemstone recommendations

Get personalised gem and rudraksha recommendations from the birth chart — with complete wearing instructions, planetary reasoning, and substitute options for every budget.

₹200–1,000/report + affiliate commissions from gem retailers. One of the highest-margin products in the Vedic astrology space. Build in 1 day.

Start free — 500 calls →API Docs

9 planets — 9 gems — all in the API

The API returns the primary gem and substitute for budget buyers. Complete wearing details included.

PlanetPrimary GemSubstituteFingerDay
SunRubyRed GarnetRing fingerSunday
MoonPearlMoonstoneLittle fingerMonday
MarsCoralCarnelianRing fingerTuesday
MercuryEmeraldGreen OnyxLittle fingerWednesday
JupiterYellow SapphireCitrineIndex fingerThursday
VenusDiamondWhite ZirconMiddle fingerFriday
SaturnBlue SapphireAmethystMiddle fingerSaturday
RahuHessoniteZirconMiddle fingerSaturday
KetuCat's EyeTiger's EyeLittle fingerThursday

How it works — 5 API calls

From birth data to a complete gem report with affiliate link — all in one async function.

1
Get the birth chart
Call /horoscope/planet-details to get all 9 planetary positions, signs, houses, and dignity states (exalted/debilitated/own sign). The chart determines which planets are weak and which gems would strengthen them.
2
Get gem suggestion
Call /extended-horoscope/gem-suggestion with the birth data. Returns the primary recommended gemstone, its planetary ruler, the finger and metal for wearing, auspicious day to wear it, and the substitute gem for budget options.
3
Get rudraksha suggestion
Call /extended-horoscope/rudraksh-suggestion for the recommended rudraksha bead(s). Returns the mukhi (face count), ruling planet, mantra, wearing instructions, and the specific life areas it strengthens.
4
Get detailed gem properties
Call /utilities/gem-details with the gem name to get weight recommendation (in carats), clarity requirements, origin preference (Ceylon vs Burmese ruby etc.), substitutes, and contraindications with other gems.
5
Display with affiliate links
Present the gem name, wearing instructions, and an affiliate link to your gem retailer partner. Gem retailers pay 5–15% commission on referred sales. A 2-carat certified ruby sells for ₹15,000–50,000 — ₹750–7,500 per conversion.

4 revenue streams from one product

Stack them for maximum LTV per user.

💎
Per-report pricing
₹99–499
One-time gem recommendation report with wearing instructions PDF
🔗
Affiliate commission
5–15%
Commission from gem retailer on referred sales — 2 carat ruby = ₹750–7,500/sale
📦
Certified gem bundles
₹500–2,000
Partner with a gem supplier to sell certified stones directly with delivery
🔄
Monthly subscription
₹199–599/mo
Updated recommendations as planetary periods shift — dashas change, gems change

Complete integration — 35 lines

Parallel fetches for gem, rudraksha, planets. Affiliate link generation. Ready to display.

// Gem and rudraksha recommendation engine
const BASE = 'https://vedintelastroapi.com/api/v1'
const KEY  = 'vai_YOUR_KEY'

const params = `api_key=${KEY}&dob=01/10/1977&tob=11:40&lat=11&lon=77&tz=5.5`

// Fetch gem, rudraksha, and planet details in parallel
const [gemSuggestion, rudrakshaRec, planets] = await Promise.all([
  fetch(`${BASE}/extended-horoscope/gem-suggestion?${params}`).then(r => r.json()),
  fetch(`${BASE}/extended-horoscope/rudraksh-suggestion?${params}`).then(r => r.json()),
  fetch(`${BASE}/horoscope/planet-details?${params}`).then(r => r.json()),
])

// gemSuggestion.response example:
// {
//   gem: "Yellow Sapphire",
//   planet: "Jupiter",
//   finger: "Index finger",
//   metal: "Gold",
//   day: "Thursday",
//   substitute: "Citrine",
//   weight_carats: "3-5 carats",
//   mantra: "Om Brim Brihaspataye Namah"
// }

// Get detailed properties for the recommended gem
const gemDetails = await fetch(
  `${BASE}/utilities/gem-details?api_key=${KEY}&gem=${encodeURIComponent(gemSuggestion.response.gem)}`
).then(r => r.json())

// gemDetails.response:
// {
//   gem: "Yellow Sapphire",
//   hardness: "9 (Mohs scale)",
//   best_origin: "Ceylon (Sri Lanka)",
//   clarity: "Eye-clean, no inclusions",
//   weight_min_carats: 3,
//   weight_max_carats: 5,
//   contraindications: ["Emerald", "Diamond"],
//   how_to_wear: "Ring on index finger of right hand on Thursday morning..."
// }

// Display to user with your affiliate link
const affiliateUrl = `https://your-gem-partner.com/search?gem=${gemSuggestion.response.gem}&ref=YOUR_AFFILIATE_ID`

return {
  primary_gem: gemSuggestion.response,
  gem_properties: gemDetails.response,
  rudraksha: rudrakshaRec.response,
  affiliate_url: affiliateUrl,
  weak_planet: gemSuggestion.response.planet,
  why: `Your ${gemSuggestion.response.planet} is in a weak position in your chart. ${gemSuggestion.response.gem} strengthens ${gemSuggestion.response.planet} energy.`,
}

7 endpoints for gem recommendation apps

All GET requests. Birth chart cached after first call — sub-10ms on repeat.

Extended
/api/v1/extended-horoscope/gem-suggestion

Primary gem recommendation, planet ruler, finger, metal, day, substitute gem — from birth chart

Extended
/api/v1/extended-horoscope/rudraksh-suggestion

Rudraksha recommendation — mukhi count, ruling planet, mantra, wearing instructions

Utility
/api/v1/utilities/gem-details

Deep gem properties — carat weight, clarity, origin, substitutes, contraindications

Horoscope
/api/v1/horoscope/planet-details

Full chart — planet signs, houses, dignity states — context for explaining the recommendation

Horoscope
/api/v1/horoscope/planet-report

Per-planet strength and interpretation — useful for explaining WHY a specific gem is recommended

Extended
/api/v1/extended-horoscope/shad-bala

Shadbala planetary strength — shows which planets are weak and need strengthening

AI
/api/v1/ai/interpret/chart

Claude AI chart reading — can include gem recommendations in the narrative

Everything you need to ship in 1 day

💍
All 9 planets covered
Ruby for Sun, Pearl for Moon, Coral for Mars, Emerald for Mercury, Yellow Sapphire for Jupiter, Diamond for Venus, Blue Sapphire for Saturn, Hessonite for Rahu, Cat's Eye for Ketu — with substitutes for every budget.
📋
Complete wearing instructions
Not just the gem name — the finger, metal (gold/silver/platinum), day of wearing, weight range in carats, mantra to recite during wearing, and how to purify the stone before wearing.
Shadbala strength analysis
Use /extended-horoscope/shad-bala to show users their planetary strength scores. Weak planets score low — this makes the gem recommendation logical, not arbitrary.
💰
Highest margin product
Gem recommendations need no ongoing compute. Once the chart is cached, every re-fetch is under 10 ms. High-margin reports: ₹499 report, ₹5 API cost, ₹494 margin.
🤖
Claude AI narrative option
Add /ai/interpret/chart to generate a full 700-word chart reading that includes gem recommendations in natural language — a premium tier for users who want explanation not just recommendations.
🌐
23 language support
Add &lang=hi for Hindi, &lang=ta for Tamil. Planet names and gem names return in native script. Critical for regional markets where customers prefer recommendations in their language.

Launch your gem recommendation app today

500 free API calls. One of the fastest products to build — most of the logic is already in the API.

Get free API key →API Docs