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.
9 planets — 9 gems — all in the API
The API returns the primary gem and substitute for budget buyers. Complete wearing details included.
| Planet | Primary Gem | Substitute | Finger | Day |
|---|---|---|---|---|
| Sun | Ruby | Red Garnet | Ring finger | Sunday |
| Moon | Pearl | Moonstone | Little finger | Monday |
| Mars | Coral | Carnelian | Ring finger | Tuesday |
| Mercury | Emerald | Green Onyx | Little finger | Wednesday |
| Jupiter | Yellow Sapphire | Citrine | Index finger | Thursday |
| Venus | Diamond | White Zircon | Middle finger | Friday |
| Saturn | Blue Sapphire | Amethyst | Middle finger | Saturday |
| Rahu | Hessonite | Zircon | Middle finger | Saturday |
| Ketu | Cat's Eye | Tiger's Eye | Little finger | Thursday |
How it works — 5 API calls
From birth data to a complete gem report with affiliate link — all in one async function.
4 revenue streams from one product
Stack them for maximum LTV per user.
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.
/api/v1/extended-horoscope/gem-suggestionPrimary gem recommendation, planet ruler, finger, metal, day, substitute gem — from birth chart
/api/v1/extended-horoscope/rudraksh-suggestionRudraksha recommendation — mukhi count, ruling planet, mantra, wearing instructions
/api/v1/utilities/gem-detailsDeep gem properties — carat weight, clarity, origin, substitutes, contraindications
/api/v1/horoscope/planet-detailsFull chart — planet signs, houses, dignity states — context for explaining the recommendation
/api/v1/horoscope/planet-reportPer-planet strength and interpretation — useful for explaining WHY a specific gem is recommended
/api/v1/extended-horoscope/shad-balaShadbala planetary strength — shows which planets are weak and need strengthening
/api/v1/ai/interpret/chartClaude AI chart reading — can include gem recommendations in the narrative
Everything you need to ship in 1 day
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.