Astrologer API #

The Astrologer API is a production-ready REST API that provides all Kerykeion features as cloud-hosted endpoints. It’s the fastest way to add professional astrology features to your application.

Get Started on RapidAPI | Full API Documentation

Why Use the API? #

Use Cases #

The Astrologer API is ideal for:

• SaaS Applications: Build astrology features into your product without licensing concerns
• Mobile Apps: Call the API from iOS/Android without bundling Python
• Prototyping: Test ideas quickly without infrastructure setup
• Commercial Projects: Use in closed-source applications
• High-Volume Workloads: Let the API handle scaling

Quick Start #

1. Get Your API Key #

Sign up at RapidAPI and subscribe to a plan. You’ll receive an API key immediately.

2. Make Your First Call #

curl -X POST "https://astrologer.p.rapidapi.com/api/v5/chart/natal" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: astrologer.p.rapidapi.com" \
  -d '{
    "subject": {
      "name": "Demo",
      "year": 1990, "month": 6, "day": 15,
      "hour": 14, "minute": 30,
      "city": "New York", "nation": "US"
    }
  }'

3. Use the Response #

The API returns JSON with:

• svg: Ready-to-display SVG chart string
• data: Complete calculation data (positions, aspects, houses)

Code Examples #

Python #

import requests

API_KEY = "your_rapidapi_key"
BASE_URL = "https://astrologer.p.rapidapi.com/api/v5"

headers = {
    "X-RapidAPI-Key": API_KEY,
    "X-RapidAPI-Host": "astrologer.p.rapidapi.com",
    "Content-Type": "application/json"
}

# Natal Chart with SVG
response = requests.post(
    f"{BASE_URL}/chart/natal",
    headers=headers,
    json={
        "subject": {
            "name": "Alice",
            "year": 1990, "month": 6, "day": 15,
            "hour": 14, "minute": 30,
            "city": "London", "nation": "GB"
        }
    }
)

result = response.json()
print(result["svg"])  # SVG chart string
print(result["data"]["sun"]["sign"])  # "Gemini"

JavaScript / TypeScript #

const API_KEY = "your_rapidapi_key";

const response = await fetch(
  "https://astrologer.p.rapidapi.com/api/v5/chart/natal",
  {
    method: "POST",
    headers: {
      "X-RapidAPI-Key": API_KEY,
      "X-RapidAPI-Host": "astrologer.p.rapidapi.com",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      subject: {
        name: "Alice",
        year: 1990, month: 6, day: 15,
        hour: 14, minute: 30,
        city: "London", nation: "GB",
      },
    }),
  }
);

const result = await response.json();
console.log(result.svg);  // SVG chart
console.log(result.data.sun.sign);  // "Gemini"

Available Endpoints #

Data Endpoints (JSON) #

Return raw calculation data without charts.

Chart Endpoints (SVG) #

Return both calculation data AND rendered SVG charts.

AI Context Endpoints #

Return AI-optimized text descriptions ready for LLM consumption.

Pricing #

Visit RapidAPI Pricing for current plans.

Typical tiers include:

• Free: Limited requests for testing
• Basic: For hobby projects and prototypes
• Pro: For production applications
• Enterprise: Custom volume and SLA

API vs Library: Which Should I Use? #

Use the Kerykeion library if:

• You’re building an open-source project (AGPL-compatible)
• You need offline calculations without internet
• You want maximum customization of internals
• You’re learning astrology programming

Use the Astrologer API if:

• You’re building a commercial or closed-source product
• You want to avoid server/infrastructure management
• You need AI-powered interpretations out of the box
• You’re building a mobile app or frontend-only project
• You want automatic updates and high availability

Resources #

• RapidAPI Dashboard: Subscribe and manage your API key
• Full API Documentation: Complete endpoint reference with examples
• Astrologer Studio: Live demo application built with the API