Astrology API
Astrology API for Vedic charts, dashas, panchang and matching
Our astrology API turns a birth date, time and place into Vedic astrology data. It returns charts, planetary periods, the Hindu calendar and match scores as JSON. Readings come in plain English.
- Zodiac
- Sidereal
- Ayanamsa
- Lahiri
- Houses
- Whole sign
- Dates
- 1850–2149
John Doe, born Aug 15, 1990, 10:30 AM, New York
{
"year": 1990,
"month": 8,
"day": 15,
"hour": 10,
"minute": 30,
"second": 0,
"latitude": 40.7128,
"longitude": -74.006,
"timezone": "America/New_York"
}{
"ascendant": { "sign": "Virgo" },
"positions": [
{ "name": "Sun", "sign": "Cancer" },
{ "name": "Moon", "sign": "Taurus" },
{ "name": "Mars", "sign": "Aries" }
]
}Features
What the astrology API covers
42 endpoints in 13 features. Each feature has its own page with a real sample response.
Birth charts
- Kundli and birth chartsPlanet positions, the rising sign, and 16 divisional charts such as the navamsa (D9).4 endpoints
- Planetary strengthShadbala, the six-part strength score, and ashtakavarga points, with each part of the score.2 endpoints
- Jaimini astrologyChara karakas, chara dasha, sign aspects and argala from the Jaimini system.1 endpoint
Timing
- Dashas (planetary periods)Vimshottari and Yogini periods, with the exact date each one starts and ends.2 endpoints
- Transits and forecastsWhere the planets are now against a birth chart, dated forecasts, and sign change and retrograde dates.7 endpoints
- Panchang and muhuratThe Hindu calendar for any date and place: lunar day, nakshatra, rahu kaal and good times.4 endpoints
- Hindu calendar and festivalsFestival dates such as Diwali, fasting days such as Ekadashi, and a month calendar, for any place.4 endpoints
Matching and doshas
Readings
- Daily horoscopesA daily horoscope for each Moon sign, and a personal daily reading for one birth chart.2 endpoints
- Readings and reportsWritten readings on career, love, wealth and personality, and a printable report.6 endpoints
- RemediesGemstone, rudraksha, mantra and havan suggestions based on the birth chart.1 endpoint
- Karmic readingA reading of Rahu and Ketu, the Moon's nodes, by sign and house. It makes no past-life claims.1 endpoint
Live demo
Run a real request
Press Run demo to call the live API with a sample birth chart. The call goes through our server, so you need no key here.
POST /v1/planets
John Doe, born Aug 15, 1990, 10:30 AM, New York
{
"year": 1990,
"month": 8,
"day": 15,
"hour": 10,
"minute": 30,
"second": 0,
"latitude": 40.7128,
"longitude": -74.006,
"timezone": "America/New_York"
}Press Run demo to see the live response here.
Quickstart
Call it from your code
Send your API key in the Authorization header and the birth details as JSON. The answer comes back as JSON. This example asks for planet positions, with the same birth details as the demo.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "$ASTROLOGY_API_BASE/v1/planets" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'Plain-English answers
Answers that name their rule
Checks such as doshas and yogas return a plain-English answer next to the exact rule they tested. The text comes from fixed rules, not an AI model.
- The same birth details always get the same answer.
- Exceptions are listed, not applied, so an astrologer can weigh them.
- Every rule is written out in the public rulebook.
{
"dosha": "manglik",
"rule": "Mars occupying house 1, 2, 4, 7, 8 or 12, counted separately from the ascendant, from the Moon and from Venus",
"present": true,
"cancellations": [
"Mars is in its own sign"
],
"answer": {
"status": "present",
"headline": "Manglik dosha is present, counted from your ascendant and your Moon. On its own this is very common: by this three-way check most charts show it from at least one place."
}
}Accuracy
Checked against Swiss Ephemeris
Planet positions come from JPL DE440s, NASA's planet data, read with Skyfield. To check them, we run the same moments through Swiss Ephemeris, a widely used reference, and compare. The numbers are the largest gaps our tests allow. An arc second (″) is 1/3,600 of a degree.
0.001″
Zodiac offset
1.5″
Planet positions
5″
Rising sign
JPL DE440s
NASA planet data
Use cases
What teams build with it
Matrimony and matchmaking sites
Kundli matching for every profile pair: the 36-point score, manglik checks and a clear verdict, even for members with no birth time.
Astrology apps
Charts, dashas, daily readings and a printable report from one API, so a small team can ship a full astrology app.
Publishers and media
Daily panchang, Moon-sign horoscopes, festival dates and sky events for any city, ready to publish every day.
Puja and spiritual stores
Gemstone, rudraksha and puja suggestions tied to each customer's chart, with the reason for every one.
AI assistants and chatbots
Real charts and plain answers for AI assistants and chatbots, so the model quotes a computed result instead of inventing one.
Dating and compatibility apps
Compatibility verdicts with their reasons for dating apps, and a reading of how two charts meet, with no score to argue over.
Pricing
Simple pricing, every endpoint on every plan
Each successful call counts once, except a full report or an annual forecast. Errors are free. Test keys are free on every plan, and paid plans start at $29 a month.
Free
$0
2,000 calls a month
Starter
$29/mo
50,000 calls a month
Growth
$99/mo
250,000 calls a month
Scale
$399/mo
2,000,000 calls a month
Common questions
All questionsHow are time zones and daylight saving time handled?
Send a time zone name such as America/New_York. The API applies the rules that were in force at the birth moment. It refuses a local time that happens twice when the clocks go back, instead of guessing.
Read the conventionsCan I get a PDF report?
The API returns a self-contained printable HTML page from /v1/report. Print it to PDF in any browser, or convert it on your side.
About the reportWhat is the rate limit, and what happens at 429?
Each live key has its own per-minute limit, so one busy key does not slow the others. Free keys get 60 calls a minute, Starter 120, Growth 300 and Scale 1,000. A full report or an annual forecast counts as 50 calls. Test keys get 10 a minute each. Over a limit, the API answers 429. The Retry-After header says how many seconds to wait, and the error code says which limit you hit. If you often get 429s, move to a larger plan.
Keys and rate limitsAstrology API
Get a free API key and make your first call
Create an account, confirm your email and create a test key. The quickstart walks you through your first request.
01
A free test key, with 1,000 requests a month
02
Try any endpoint in your browser first
03
Every rule published, so you can check any answer