New Numerology API

Services

Astrology API and Numerology API: one key, one plan

API for Astrology (apiforastrology.com) offers two APIs on one account. The Astrology API has 65 endpoints, and the Numerology API has 16. One API key, one plan and one invoice cover both. You send birth details, a name or a date as JSON. You get charts, numbers and readings back.

Updated

Get a free API keyWhich API do I need?
© API for Astrology (apiforastrology.com). "One key, many services". All rights reserved. Not to be copied or reused.One key, many servicesafa_live_…Your API keyGatewayAstrologyAPILive14 features · 65 endpointsNumerologyAPILive8 features · 16 endpointsOne account · one key · one plan · one invoice
A person holding a phone up to a starry night sky

Live

Astrology API

Vedic astrology as JSON: 65 endpoints in 14 features. They cover birth charts, planetary periods (dashas), the Hindu calendar (panchang), matching and transits. They also cover yogas (planet combinations), doshas (chart flaws), readings and remedies.

Every answer follows a published rule, and the same birth details always get the same answer. Start with a free test key, then pick the Free plan or a paid plan when you go live.

About the Astrology APISee all 14 featuresSee pricing

Live

Numerology API

Indian and Western numerology as JSON

16 endpoints in 8 features. They cover the mulank (birth day number), the bhagyank (destiny number), name numbers and the Lo Shu grid. They also cover name and number checks, compatibility, the personal year, baby names and a full report, in English or Hindi.

It uses the same key, the same plan and the same reading credits as the Astrology API.

About the Numerology APISee all 8 featuresNumerology API pricing

Which API do I need?

Pick by what your users can give you and what you want to show them. Many apps use both, with the same key.

The Astrology API and the Numerology API compared
QuestionAstrology APINumerology API
What you sendA birth date, the time and the place (latitude, longitude and time zone)A name in English letters and a birth date. No time or place
What comes backBirth charts, dashas, the panchang, matching scores, transits, doshas and written readingsMulank, bhagyank and name numbers, the Lo Shu grid, name and number checks, compatibility and a report
Typical appsAstrology apps, matrimony and dating sites, publishers, astrologer platformsNumerology apps, naming tools, matrimony sites, astrologer platforms
Endpoints6516
What a call uses1 call for a calculation; written readings from 1 reading creditReading credits for every answer, from 1 to 25
LanguagesEnglish and HindiEnglish and Hindi
Start hereAstrology quickstartNumerology quickstart

What one account gives you

These come with every plan, Free included, and cover every service we offer.

  • Up to 20 API keys, so each app or server can have its own key.
  • Test keys with 1,000 free calls a month, and live keys for production.
  • A team with Owner, Admin and Member roles.
  • A usage dashboard by day, endpoint, key and month.
  • Email alerts at 80% and 100% of your calls and reading credits.
  • One usage dashboard for both APIs, with the requests of each API shown apart.

How API keys workThe docs for every API

Languages

Readings in your users’ language

The Astrology API and the Numerology API answer in English and Hindi today. Names and reading text change with the language. Endpoint paths, codes and error messages stay in English.

  1. Supported

    2 languages

    Works today

    • EnglishDefault
    • हिन्दीHindilang=hi

  2. Coming soon

    2 languages

    Next on the list

    • 中文Chinese
    • EspañolSpanish

  3. Planned

    9 languages

    Not scheduled yet

    • தமிழ்Tamil
    • తెలుగుTelugu
    • 日本語Japanese
    • ಕನ್ನಡKannada
    • FrançaisFrench
    • മലയാളംMalayalam
    • PortuguêsPortuguese
    • РусскийRussian
    • বাংলাBengali

Need a language sooner?Tell us which one. Requests help decide what comes next, and a language in progress gets a target quarter once its schedule is set.

Request a language

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.

    Astrology conventionsNumerology 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.

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

Questions about our services

Do I need a separate key for each service?

No. One account and one set of API keys work for every service we offer.

Is there one plan for every service?

Yes. The same plans and prices cover every service, and you get one invoice.

Which APIs can I use today?

Two: the Astrology API and the Numerology API. The Astrology API covers Vedic birth charts, dashas, panchang, kundli matching, transits, yogas and doshas, readings and remedies. The Numerology API covers mulank, bhagyank and name numbers, the Lo Shu grid, name and number checks, compatibility, Western numbers and reports. Both answer as JSON, with the same key.

Can one app use both APIs?

Yes. The same key calls both: the Astrology API at /api/astrology/v1 and the Numerology API at /api/numerology/v1. A matrimony site, for example, can show the kundli match and the numerology match side by side.

Do numerology calls use my astrology credits?

They use the same monthly reading credits, from one pool. Your plan has one allowance of calls and one of reading credits, whichever API you call.

How is usage counted?

Calculations use calls and written readings use reading credits. Both come from your plan's monthly allowance, which starts again on the 1st of each month (UTC). Errors are free.

How do I start?

Create a free account, confirm your email and create a test key. Then follow the quickstart to make your first call in a few minutes.

Read the quickstart

Questions about each API itself are on the astrology API FAQ and the numerology API FAQ.

API for Astrology

Start with either API

Create a free test key and call any endpoint of either API.

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