500 free calls · No credit card

Astrology Compatibility API
for Dating & Matchmaking Apps

Guna Milan, Nakshatra matching, Rajju Vedha, and AI synastry narratives — all in one API. Swiss Ephemeris accuracy. Results verified against Jagannatha Hora.

Power the compatibility layer of your dating app, matrimony platform, or relationship insights product with 8 dedicated matching endpoints and a Claude AI narrative layer no other API offers.

Start free — 500 calls →View API docs

8 matching endpoints. Every compatibility system covered.

All endpoints accept the same birth data parameters. Swap between systems with one URL change.

Core
GET /api/v1/matching/north-match

Ashtakoot Guna Milan — 36-point compatibility score with all 8 koot breakdowns (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi)

Core
GET /api/v1/matching/south-match

Dasha Porutham — South Indian 10-porutham compatibility system used in Tamil and Telugu matrimony

Popular
GET /api/v1/matching/nakshatra-match

Nakshatra-level compatibility: Tara Bala, Vashya, Rajju Vedha, and Vedha dosha check between two birth charts

Popular
GET /api/v1/matching/aggregate-match

Combined North + South compatibility with a single aggregate score — ideal for apps targeting pan-India users

Western
GET /api/v1/matching/western-match

Western synastry compatibility — Sun/Moon/Venus/Mars inter-aspects with orbs and strength scores

Dosha
GET /api/v1/matching/rajju-vedha-match

Rajju and Vedha dosha check — detects the two most critical compatibility blocks in Vedic matching

Bulk
GET /api/v1/matching/bulk-north-match

Up to 10 compatibility pairs in one API call — perfect for batch matching or recommendation engines

AI
GET /api/v1/ai/compatibility

Claude AI synastry narrative — 500-word human-readable compatibility reading covering strengths, challenges, and life themes

One request. Full Guna Milan breakdown.

The response includes every koot score, dosha flags, and a match percentage — everything your UI needs in a single call.

// Fetch Ashtakoot Guna Milan compatibility score
const BASE = 'https://vedintelastroapi.com/api/v1'

const result = await fetch(
  `${BASE}/matching/north-match` +
  '?api_key=vai_YOUR_KEY' +
  // Partner 1 — groom
  '&m_dob=10/08/1990&m_tob=07:30&m_lat=28.6139&m_lon=77.2090&m_tz=5.5' +
  // Partner 2 — bride
  '&f_dob=22/03/1992&f_tob=14:10&f_lat=12.9716&f_lon=77.5946&f_tz=5.5'
).then(r => r.json())

// Sample response
// {
//   "status": 200,
//   "response": {
//     "total_points": 28,
//     "maximum_points": 36,
//     "match_percentage": 77.8,
//     "koots": {
//       "varna": { "points": 1, "max": 1, "description": "Compatible varna" },
//       "vashya": { "points": 2, "max": 2 },
//       "tara":   { "points": 3, "max": 3 },
//       "yoni":   { "points": 3, "max": 4 },
//       "graha_maitri": { "points": 5, "max": 5 },
//       "gana":   { "points": 5, "max": 6 },
//       "bhakoot":{ "points": 7, "max": 7 },
//       "nadi":   { "points": 0, "max": 8, "dosha": true }
//     }
//   },
//   "remaining_api_calls": 4823
// }

Built for production matchmaking

🔭
Swiss Ephemeris precision
Every compatibility score is computed from exact planetary positions via local Swiss Ephemeris. No rounding, no approximations — results match Jagannatha Hora output within 0.5°.
⚡
Sub-200 ms cached responses
Once a user's birth chart is computed, it is cached in Supabase permanently. Second and subsequent compatibility calls for the same person return in under 200 ms.
🌐
27 languages
Compatibility results and nakshatra names in English, Hindi, Tamil, Telugu, Kannada, Malayalam, Bengali, and 20 more regional languages. Add `lang=hi` to any request.
🤖
AI synastry narratives
The /ai/compatibility endpoint returns a 500-word Claude AI reading covering shared values, communication styles, karmic themes, and specific life domains.
📦
Bulk matching for recommendations
The bulk endpoints process up to 10 pairs per call. Feed them a shortlist of candidates and rank by Guna Milan score to power a recommendation engine.
🛡️
Dosha detection built in
Mangal Dosha, Kaal Sarp Dosha, Rajju Vedha, and Papasamaya — all compatibility blockers are surfaced automatically with severity and cancellation conditions.

Pricing that scales with your user base

Start free, scale to millions of compatibility checks without switching providers.

Free
₹0
500 calls/mo
Developer
₹750/mo
5,000 calls/mo
Most Popular
Starter
₹4,100/mo
1,00,000 calls/mo
Professional
₹12,500/mo
10,00,000 calls/mo
✓ No credit card for free plan✓ Annual billing: 2 months free✓ Top-up packs never expire✓ USD pricing available

Add compatibility matching to your app today

500 free API calls/month. Verified Vedic accuracy. No credit card required to start.

Start free →View pricing