Astrology API Documentation for Developers

Learn how to authenticate, make requests, and work with astrology, metaphysics, and spiritual timing endpoints using AstroAPI.

🔮 Horoscope Widget API
Embed a live, interactive horoscope chart with single-wheel and bi-wheel support.
🔐 Authentication API
Authenticate securely using API keys and JWT tokens.
🌙 Birth Chart API
Generate complete natal charts with planets, houses, and angles.
🪐 Astrology Transits API
Calculate real-time and predictive planetary motion.
✨ Planetary Aspects API
Compute planetary angles for natal charts and synastry.
🏠 Astrology Houses API
Placidus, Whole Sign, Koch, Equal, and more.

// JavaScript Example (Sample Only)
fetch("https://api.astroapi.io/v1/birthchart", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    date: "2000-01-01",
    time: "12:00",
    lat: 0.0,
    lon: 0.0,
    tz: "UTC"
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

# Python Example (Sample Only)
import requests

url = "https://api.astroapi.io/v1/birthchart"

payload = {
    "date": "2000-01-01",
    "time": "12:00",
    "lat": 0.0,
    "lon": 0.0,
    "tz": "UTC"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())