Guides
Guides & tutorials
These guides cover building real integrations against AstrologyAPI: chart apps, matching, bots, and PDF reports. They also cover how to feed API output into an LLM.
Other guides cover the details that decide whether your charts are right: timezones, unknown birth times, and going to production. These guides are written for developers who are integrating the API, not evaluating it.
Build something
Build a complete kundli, step by step
Go from a place name to charts, the current dasha, and planet strength. Every call in one chain, with the exact fields.
Build a Western birth chart, step by step
Go from a place name to a full natal chart: planets, houses, aspects, a wheel chart image, and text reports.
Build a birth chart app with Next.js
Call the birth details and planetary position endpoints from a Next.js API route and render the chart in the browser.
Add Kundli matching to your app
Send two birth records to the ashtakoot endpoint and show a compatibility score to your users.
Build a daily horoscope Telegram bot
Wire a Telegram bot backend to the sun sign prediction endpoint and post a daily message to subscribers.
Generate your first PDF report
Send birth details to a PDF endpoint and get back a downloadable horoscope report.
Add palm reading to your app
Upload a palm photo, get a palm id back, and read structured analysis from the palmistry endpoints.
Get the details right
Timezones, DST, and historical birth data
Convert a birth time and place into the decimal UTC offset the API expects, including daylight saving edge cases.
When the birth time is unknown
See which calculations need an exact birth time and which still work with only a date.
Credits, errors, and going to production
Handle credit limits and error responses before you move from testing to production traffic.
Ayanamsha, house systems, and why charts differ
Six ayanamsha systems, two zodiacs, and several house systems: why two apps disagree about the same birth.
Access tokens vs User ID + API key
The two ways to authenticate, how each request looks, and why new projects should start with tokens.
Pay as you go with a wallet
Top up a wallet, create an access token, and call any API without a subscription.
Evaluate and migrate
How to choose an astrology API
The questions to ask before committing to a provider, and how to test each one in an afternoon.
Move from self-hosted Swiss Ephemeris
Map common swisseph workflows to API endpoints, and see what changes about timezones and caching.