API for Astrology

Use case

Kundli matching API for matrimony sites

Matrimony and matchmaking sites need a kundli match for every pair of profiles, fast and the same every time. Our API gives the 36-point guna milan score, the manglik check and a one-word verdict with its reasons. Members who do not know their birth time can still be matched.

Get a free API keyTalk to us
POST /v1/matching200 OK
{
  "conclusion": {
    "verdict": "workable",
    "headline": "This match can work. The main checks pass with 22.5 out of 36 points, but a few things need a closer look before you decide. They are listed below."
  },
  "total": 22.5,
  "out_of": 36
}
The match verdict for Jane Doe and John Doe, what it means in plain words, and the guna milan score: points out of 36 from eight traditional factors. Real output for Jane Doe (bride), born Mar 22, 1992, 2:45 PM, Chicago, and John Doe (groom), born Aug 15, 1990, 10:30 AM, New York.

How to add kundli matching to a matrimony site

  1. 01

    Score every pair

    POST /v1/matching

    The 36-point score, the manglik comparison, the southern checks and a verdict: "favourable", "workable" or "difficult". Show the verdict and its headline on the match card.

  2. 02

    Match members with no birth time

    POST /v1/matching/nakshatra

    Many members know their nakshatra but not their birth time. This gives the same score and a verdict from the two nakshatras alone.

  3. 03

    Read the two charts together

    POST /v1/matching/parasparam

    For a full report: each person's planets in the other's houses, read for marriage and for friendship. Nothing is scored.

  4. 04

    Forecast the couple

    POST /v1/forecast/couple/{theme}

    After a match is accepted: a love, career or wealth forecast for the two people, and what they share.

Tips for going live

  • Matching is not symmetric. Send the bride and the groom in their own fields, and cache on the ordered pair, never on sorted IDs.
  • The same request always gets the same answer, so serve repeats from your cache.
  • Show the verdict and its reasons, not the score alone. Two pairs can both score 22 and be nothing alike.
  • Add a proposed wedding date (as_of) to check dasha sandhi for both people.
  • At a 429 error, wait for the seconds in the Retry-After header. Frequent 429s mean it is time for a larger plan.

Pricing

Every plan can call every endpoint. Test keys are free on every plan, with 1,000 requests a month. Paid plans start at $29 a month, and only successful calls count.

See pricing

Features used here

Astrology API

Start with a free test key

Create an account and a test key, then try each step above. Need more than the largest plan? Write to us.

  1. 01

    A free test key, with 1,000 requests a month

  2. 02

    Try any endpoint in your browser first

  3. 03

    Every rule published, so you can check any answer

Get a free API keyOpen the API reference