Use case
Build an astrology app on one API
Building an astrology app takes two kinds of work: the app people see, and the astrology behind it. Our API is the astrology part: birth charts, planetary periods, daily readings, matching and a printable report. Your team builds the screens, the accounts and the brand, and ships sooner.
POST /v1/reading/section/topic:personality?as_of=2026-10-01200 OK{
"section": {
"id": "topic:personality"
},
"blocks": [
{
"answer": {
"headline": "You tend to have a clear sense of who you are, and people often notice it. Your energy and confidence usually come easily, and you recover well when life gets hard."
}
}
]
}How to build an astrology app on the API
- 01
Onboarding: the birth chart
POST /v1/planetsAsk for the birth date, the local time, the place and its time zone. The first call returns the rising sign and all nine planets for the chart screen.
- 02
Divisional charts
POST /v1/chart/{division}The navamsa (D9) or any other of the 16 charts, from the same birth details.
- 03
A timeline
POST /v1/dasha/vimshottariThe running planetary period and every date, for a timeline or a "your current period" card.
- 04
- 05
Readings
POST /v1/reading/section/{section_id}Topic readings such as career or marriage, each opening with a plain answer.
- 06
What to build, and what to get from the API
Your team builds
- Your app's screens, sign-up and accounts
- Payments and subscriptions
- Reminders and push notifications
- Your brand, your voice and your design
The API gives you
- Planet positions and the 16 divisional charts
- Dasha dates, transits and the panchang
- Kundli matching and dosha checks
- Readings and a printable report, in plain English
Tips for going live
- Call the API from your own server, and never put the key in the app.
- Cache each birth chart by a hash of the birth details. It never changes.
- Refresh daily readings and transits on a schedule, not every time the app opens.
- The API refuses a local time that happens twice when the clocks go back. Ask the user which one they mean.
- The monthly quota covers your whole account, so limit how often each user can start new calls.
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 pricingFeatures used here
- Kundli and birth chartsPlanets, rising sign and D1 to D60 charts
- Dashas (planetary periods)Vimshottari and Yogini dasha dates
- Panchang and muhuratTithi, nakshatra, rahu kaal and good times
- Kundli matchingGuna milan, manglik check and a verdict
- Transits and forecastsGochar, sign changes and retrograde dates
- Daily horoscopesMoon-sign horoscopes and personal daily readings
- Yogas and doshasManglik, kaal sarp and pitra dosha checks
- Planetary strengthShadbala and ashtakavarga
- Jaimini astrologyChara karakas, arudha and chara dasha
- Readings and reportsTopic readings and a printable kundli report
- RemediesGemstones, rudraksha and mantras
- Karmic readingRahu and Ketu, with no past-life claims
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.
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