Build something real.
Step-by-step walkthroughs from your first authenticated request to shipping production astrology features — Kundli, horoscopes, PDFs, AI Chat, and more.
Start here
Everything you need to authenticate, integrate, and localize AstrologyAPI inside your product — in the order you need it.
Start integrating astrology API with our step-by-step guide
Get Started →Explore and test our API endpoints with our Postman collection
Get Started →Explore comprehensive API documentation and reference materials
Get Started →Use a wallet access token to call the API directly from a browser or mobile app, without shipping your user ID and key to the client.
Get Started →Make your first call
Authenticate with HTTP Basic: your user ID as the username, your API key as the password. Every endpoint takes a POST request, including read-only ones like planets. Run this from your server — json.astrologyapi.com sends no CORS headers, so a direct call from browser JavaScript fails.
curl -X POST https://json.astrologyapi.com/v1/planets \
-u "YOUR_USER_ID:YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"day": 10,
"month": 5,
"year": 1990,
"hour": 19,
"min": 55,
"lat": 19.2056,
"lon": 25.2056,
"tzone": 5.5
}'See the Quick Start guide for how to get a user ID and API key and read the full response.
Guides and tutorials
Complete integrations, written for developers who are building, not evaluating.
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.
Ground an LLM on computed charts
Feed computed chart data into a prompt so an LLM explains a birth chart instead of guessing at planetary positions.
Credits, errors, and going to production
Handle credit limits and error responses before you move from testing to production traffic.
Every API. One key.
All 300+ endpoints live under a single authentication header. Pick your tradition and start reading.
Build Kundli generators, Panchang tools, muhurta pickers, and matchmaking features with 300+ verified Jyotish endpoints — including KP, Lalkitab, and Varshaphal.
- Birth chart calculations and planetary positions
- Panchang, muhurta, and ritual timing APIs
- Kundli matching and dosha analysis
- Regional language support and timezone intelligence
Generate natal charts, synastry overlays, composite maps, and transit reports with professional interpretations reviewed by senior astrologers.
- Natal, transit, synastry & composite chart generation
- Rich interpretations and professional reports
- Planetary ephemeris and aspect calculations
- Customizable chart visualizations
Schedule-ready JSON feeds for daily, monthly, and yearly horoscopes across all 12 signs — with love, career, health, luck, and lunar calendar content.
- Daily and Monthly JSON feed for 12 Zodiac Signs
- Daily insight on todays' Love, Career, Health, Luck and more
- Detailed monthly report inclusive of planet transit details
- Campaign-ready content for retention
On-demand PDF generation for Kundli, matchmaking, Varshaphal, natal, synastry, and life forecast reports — white-labeled, multi-language, delivered by link or webhook.
- White-label Kundli, matchmaking & Varshphal reports
- Multi-language support and custom themes
- Automated delivery via email or download links
- Ready layouts for natal, transit & synastry reports
Add structured tarot readings to any app: general spreads, yes/no responses, and card-by-card interpretations for all 78 cards of the Major and Minor Arcana.
- General tarot card predictions
- Yes/No tarot question responses
- Detailed card interpretations
- Visual card representations
Upload a palm photo, get back a palm ID, and read structured hand type, finger, and line analysis from the same authenticated endpoint set.
- Palm photo upload by URL or base64, up to 5MB
- Palm ID generation from a photo and date of birth
- Hand type, finger, and mount analysis
- Major and minor palm line detection
AI and automation
Put chart data in front of an LLM, or connect it directly to one.
A hosted conversational endpoint that answers questions about a single birth chart, in Vedic or Western mode.
Get Started →Astrology calculation tools for LLM agents and IDEs, exposed over the Model Context Protocol.
Get Started →Feed computed chart data into a prompt so an LLM explains a birth chart instead of guessing at planetary positions.
Get Started →