API Documentation
Welcome to the API Docs
Explore our comprehensive astrology API with support for Western, Vedic, Chinese, and numerology systems. Each endpoint includes sample code in Python, PHP, and Node.js.
Prefer a guided Postman flow? Fork the public Start Here collection and begin from the production-ready request set.
FreeAstroAPI is a proprietary hosted service. Its public OpenAPI 3.1 contract, JSON Schemas, and synthetic examples are published separately under Apache License 2.0 in the official API specification repository.
Quickstart
Build your first request in 30s
Base URL: https://api.freeastroapi.com
curl -X POST 'https://api.freeastroapi.com/api/v1/natal/calculate' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_KEY' \
-d '{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"New York"}'Base URL
https://api.freeastroapi.comAll Endpoints
Western Astrology
Metered AI chat grounded in Western astrology tools
Tropical planetary positions
Rank famous-person birth chart matches with explanations
Planetary positions across a date range
Lines, parans, relocation rankings, and relocated charts
Specialized Sun, Moon, ASC, MC
Single-date transit snapshot against a natal chart
Monthly transit intervals for calendar and Gantt UIs
Regiomontanus in-mundo directions with latitude doctrine and lunar secondary motion
Simple zodiacal 1 year equals 1 degree timing
Annual birthday chart & themes
Sun, Moon, and other planet returns
Raw relationship aspects, overlays, and scores
Relationship compatibility
Custom branded Western report PDFs
Daily horoscope by zodiac sign
Personalized daily forecast
Personalized seven-day forecast
Daily romantic or friendship synastry forecasts
Western Visual Charts (SVG)
Vedic Astrology
V2 sidereal positions
KP cusps, sub lords, significators, dasha, and rendering
SVG and PNG Kundli charts with visual examples
V2 all-in-one endpoint
V2 planetary periods
V1 insight facts
V2 transit windows
V2 transit insight facts
Free-plan forecast with timing and explainable scores
Metered AI chat grounded in Vedic MCP tools
V2 yoga catalog
V2 Shadbala & Ashtakavarga
V2 D1, D9, D10, D60, etc.
V2 daily almanac
V2 compatibility from birth data
V2 manual Moon input
Chinese Astrology
Utilities (Free)
Authenticated city and locality autocomplete
Connect FreeAstroAPI directly to AI tools
llms.txt, sitemap, robots, and AI discovery guidance
Phase data & SVG visuals
Monthly moon calendar & sign ingresses
Sky event feed for mobile push notifications
Timezone engine and historical LMT
Use StarFont Sans and Serif in any frontend app
Deploy-ready app templates