New Numerology API

Buyer's guide

How to choose a Vedic astrology API

Choose an API whose numbers you can check. Its zodiac should match your users, and its text should be ready to show. There are ten checks: coverage, accuracy, the zodiac, readings, languages, free testing, pricing, docs, privacy and clock changes. Each one below says what to ask and how to test it in an afternoon. We wrote this guide, and we make API for Astrology (apiforastrology.com). At the end, we show how our API answers each check, and what it does not do.

Updated

The ten checks

  1. 1. Coverage for your app

    Ask: Does it do every job your app needs? Write the list first. A Vedic app may need birth charts and kundli matching (comparing two charts for marriage). It may need dashas (planet periods) and transits (where the planets are now). It may also need the daily panchang (the Hindu calendar) and festivals. Readings in your users' languages and a drawn chart may matter too.

    Test: Find each job in the provider's feature list before you test anything else. A missing job means a second provider, or code your team must write and keep up to date.

  2. 2. Accuracy you can check

    Ask: Does the provider publish how it tests its numbers, and against what?

    Test: Send one birth chart and compare the planet degrees with Swiss Ephemeris or the software your astrologers trust.

  3. 3. The zodiac, ayanamsa and houses

    Ask: Is it the sidereal (Vedic) zodiac? Which ayanamsa (the zodiac offset) is the default, and can you change it? Which house system (the way the chart is split into 12 houses) does it use?

    Test: Check the Moon sign of a known chart. A wrong zodiac or ayanamsa often moves it to the next sign. For John Doe, a Western (tropical) chart puts the Moon in Gemini. The Vedic chart puts it in Taurus.

  4. 4. Readings, not only numbers

    Ask: Does it return text your users can read? Is that text written by fixed rules or made up by an AI model each time?

    Test: Call the same chart twice. Fixed rules give the same words both times, and you can trace each line to a rule.

    See a full sample report from our API
  5. 5. Your users' languages

    Ask: Are names and reading text available in the languages your users read, such as Hindi?

    Test: Ask for the same reading in each language you need and have a native speaker read it.

  6. 6. A free way to test

    Ask: Can your team build and test without a card, and does test traffic count against your paid limits?

    Test: Sign up and make your first call. It should take minutes, not a sales call.

    Try our free kundli tool in your browser
  7. 7. Pricing you can predict

    Ask: What does one call cost, and does a long reading cost more than a calculation? What happens when you run out?

    Test: Price your expected month: how many charts, how many readings, how many users at once.

  8. 8. Docs your team can use

    Ask: Is there an OpenAPI file and a Postman collection? Do the docs show real requests and answers, and explain every error?

    Test: Import the collection and send three calls without reading anything else.

  9. 9. Privacy and data

    Ask: Does the provider store the birth details you send? Where do they go?

    Test: Read the security page and the privacy policy before you send real users' data.

  10. 10. Birth times on a clock change

    Ask: What happens when a birth time happens twice or never? When clocks go back, one hour happens twice. When they go forward, one hour is skipped.

    Test: Send a birth at 1:30 AM on Nov 2, 2025, in New York. That time happened twice. A careful API asks which one you mean instead of guessing.

Test any API in one afternoon

  1. Pick one test chart and use it everywhere. Our docs use John Doe, born Aug 15, 1990, at 10:30 AM in New York.
  2. Compare the planets, the rising sign and the Moon's nakshatra (birth star) with a reference you trust.
  3. Ask for one written reading in each language you need, and read it as your users would.
  4. Send calls quickly until you get a 429 (too many requests), and check that the error says what to do.
  5. Price one real month of your traffic on each provider's pricing page.

How API for Astrology answers each check

CheckAPI for Astrology
Coverage14 features and 65 endpoints. They cover birth charts, kundli matching, dashas, transits, the daily panchang, festivals and muhurat (good times to start something). Readings in English and Hindi. Chart images as SVG or PNG, in North, South or East Indian style.See all astrology API features
AccuracyChecked against NASA JPL Horizons on 25,571 positions from 1850 to 2149. The Sun and planets agree within 0.001 arc seconds, and the Moon within 0.011 arc seconds. An arc second is 1/3,600 of a degree. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. The Lahiri ayanamsa (zodiac offset) agrees with Swiss Ephemeris within 0.001 arc seconds.How we test accuracy
Zodiac and housesSidereal (Vedic) zodiac, ayanamsa Lahiri (the default), KP, Raman, Yukteshwar, Fagan-Bradley, J. N. Bhasin, Usha-Shashi, True Chitra. KP is Krishnamurti Paddhati, a school of Vedic astrology. Whole-sign houses (each sign is one house). For KP, the API also gives Placidus cusps, where a house can start anywhere inside a sign. Dates from 1850 to 2149.Our zodiac and house rules
ReadingsPlain-English readings from a fixed library, chosen by stated rules, not an AI model. The same birth details always get the same words. All 480 rules are public.Read all 480 reading rules
LanguagesEnglish and Hindi: names and reading text. Send lang=hi for Hindi. Endpoint paths, codes and error messages stay in English.How answers in other languages work
Free testingA Free plan with 2,000 calls and 150 reading credits a month, no card needed. Test keys on every plan get 1,000 more calls a month.Compare the Free plan with paid plans
PricingCalculations use calls; written readings use reading credits. Errors are free. Paid plans start with Starter at $29 a month. That launch price lasts until March 31, 2027, and then it is $39 a month.Reading credits for each kind of reading
Docs65 astrology endpoints and 16 numerology endpoints, one key for both. OpenAPI file, Postman collection, examples in curl, JavaScript, Python and PHP.Browse the API reference
PrivacyBirth details are used only to compute the answer. Request bodies are not stored.How we handle birth details
Clock changesA local time that happens twice or never is refused, not guessed. The API answers with a 422 error, which means the request can't be used as sent. Send timezone_fold or a UTC offset to say which one you mean.How the API handles clock changes

What it does not do

  • Western (tropical) astrology. It is Vedic only.
  • PDF files. A full report comes as one printable HTML page, which any browser saves as a PDF.
  • SDKs to install. Any language that can make an HTTPS call and read JSON works.

Choosing a numerology API as well? The numerology buyer’s guide has its own checks.

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

Questions buyers ask

All questions
What is the best Vedic astrology API?

The one that passes these checks for your app. Run the same birth chart through two or three APIs. Then compare the planet degrees, the reading text and the cost of one real month of your traffic.

Do I need Swiss Ephemeris accuracy?

You need an API that publishes how it tests and lets you check it. A birth time that is off by one minute moves the Moon about 33 arc seconds. That means a good API's calculation error is far smaller than the error in most birth times.

See how we test
Should I use an API or a software library?

A library runs on your servers, and your team keeps it up to date. An API needs no setup on your side. Ours also returns written readings and calendars, not only positions.

Kundli software vs kundli API
Which ayanamsa should my app use?

Lahiri, the default here, unless your users follow KP astrology or B. V. Raman's school. Our API takes eight ayanamsas, those three among them, so you can offer a choice.

Lahiri, KP or Raman compared

Astrology API

Run the checks on us

Create a free account and get a test key. The quickstart makes your first call in a few minutes.

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