New Numerology API

Use cases

Astrology API use cases

API for Astrology (apiforastrology.com) is a Vedic astrology API for products such as matrimony sites, dating apps, astrology apps, AI chatbots, publishers and gemstone stores. Each of the 9 pages below covers one kind of product: the calls it makes, a real response, what it costs and tips for going live.
Get a free API keyTalk to us

Updated

© API for Astrology (apiforastrology.com). "Use cases explained". All rights reserved. Not to be copied or reused.Astrology appVirgo risingMatrimony site22.5/36Gemstone storeEmeraldNews site6:52 AMPuja storeDiwali Nov 8AI assistantJun 2027Dating appAstrologer deskRule YG-07Baby namesRohiniVaplanetsmatchinggemstonepanchangfestivalssadesatimatchingrulesbirth-detailsAPI

How it works

  1. 1Pick the page closest to your product. Each one lists the calls to make, in order.
  2. 2Every step links to its endpoint in the API reference, and the first step comes with ready-to-copy code.
  3. 3Build with a free test key, then switch to a live key on the Free plan or a paid plan when you launch.

Who it's for

Pick the one closest to yours

A bride and groom looking at a phone together

Matrimony and matchmaking sites

Kundli matching for every profile pair: the 36-point score, manglik checks and a clear verdict. It works even for members with no birth time.

Calls: POST /v1/matching

A person holding a phone up to a starry night sky

Astrology apps

Charts, dashas, daily readings and a printable report from one API. A small team can ship a full astrology app with it.

Calls: POST /v1/planets

Reading the news on a tablet beside a cup of coffee

Publishers and media

Daily panchang, Moon-sign horoscopes, festival dates and sky events for any city, ready to publish every day.

Calls: GET /v1/panchang/daily

Two women looking at a phone during Diwali

Puja and spiritual stores

Gemstone, rudraksha and puja suggestions tied to each customer's chart, with the reason for every one.

Calls: POST /v1/dosha/all

A woman chatting on a laptop at night

AI assistants and chatbots

Real charts and plain answers for AI assistants and chatbots. Give the model a few endpoints as tools (function calling), so it quotes a computed result, not a guess.

Calls: POST /v1/summary

A phone showing a new match in a dating app

Dating and compatibility apps

Compatibility verdicts with their reasons for dating apps. Also a reading of how two charts meet, with no score to argue over.

Calls: POST /v1/matching

An astrologer going over a birth chart with a client on a laptop

Astrologer consultation platforms

Charts, dashas and yogas for every client, with the rule behind each answer. Send a printable report after the session.

Calls: POST /v1/planets

A mother holding her newborn and looking at a phone

Baby name apps

The birth star, its quarter and the traditional first syllable for a baby's name. It works from the birth date, time and place.

Calls: POST /v1/planets

A woman choosing colorful gemstones at a market table

Gemstone and jewelry stores

A gemstone picked from each customer's chart, with the reason. Also the metal, the finger and the day to first wear it.

Calls: POST /v1/reading/section/topic:remedy-life-gemstone

Building something else?Tell us what you are making and we will point you to the calls that fit.Tell us about it

Free tools

Try the API with no code

Ten free tools run on our APIs. Enter a birth date, time and place, or a name and a birth date, and see the answer in your browser.

All free tools

  • Free kundli

    Your Vedic birth chart: the rising sign and all nine planets, with sign, house and nakshatra.

    Make my kundli

  • Kundli matching

    The 36-point guna milan score, the manglik check and a plain verdict for two people.

    Match two charts

  • Today's panchang

    Tithi (lunar day), nakshatra, sunrise, rahu kaal and the choghadiya (good and bad parts of the day) for your own city.

    See today's panchang

  • Manglik dosha check

    Whether Mars makes a chart manglik, counted three ways, with any exceptions.

    Check for manglik dosha

  • Sade sati check

    Whether sade sati, Saturn's 7.5-year pass around your Moon sign, is running for you, which phase, and the dates.

    Check my sade sati

  • Nakshatra finder

    Your birth star: the Moon's nakshatra, its quarter (pada), its ruler and your Moon sign.

    Find my nakshatra

  • Numerology calculator

    Your mulank, bhagyank and name number from a name and a birth date.

    Find my numbers

  • Life path number calculator

    Your life path number with master numbers kept, plus your expression, soul urge and personality numbers.

    Find my life path

  • Name numerology calculator

    A name's Chaldean and Pythagorean numbers, with other spellings compared against your birth date.

    Check my name

  • Lo Shu grid calculator

    The Lo Shu grid from a birth date, with missing and repeated numbers and full and empty lines.

    Draw my Lo Shu grid

Why pick this API

Why teams pick this API

Users ask why their chart says what it does. These five parts of the API help you answer them.

  • 01

    Every rule is public

    The rulebook lists each rule the API uses, in plain words, so your team can check any answer. A practicing astrologer reviews the rules.

    Browse the rulebook
  • 02

    The same answer every time

    Answers come from fixed rules, not an AI model. The same birth details always get the same result and the same words.

  • 03

    English and Hindi

    Add lang=hi for Hindi. Names and reading text come from the same calculation as the English answer.

    Read the conventions
  • 04

    Checked accuracy

    We check planet positions against NASA JPL Horizons. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. An arc second is 1/3,600 of a degree. Our tests fail if they drift.

    Sources: NASA JPL planet data (DE440), Swiss Ephemeris, NASA JPL Horizons

    See how we test
  • 05

    One key for every product

    One account, one API key and one plan cover the Astrology API and the Numerology API, with one invoice.

    See our APIs

Astrology API

Start with a free test key

Create an account and a test key, then follow the steps for your product. Or try a request in the API reference first.

Get a free API keyOpen the API reference

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer