The Astrology API
with real-time AI voice.

AI voice + chat astrologers, Vedic & Western astrology, numerology, transits, and white-label PDF reports. 260+ endpoints in one API key. Sub-50ms responses.

First call in 60 seconds. Production in a weekend.

Verified against Swiss Ephemeris
Plans from $29/mo
Median response under 50ms
All systems · One key

Eight intelligence domains.
One subscription.

From classical Parashari Vedic methods to Western synastry, KP sub-lords to Lal Kitab remedies — every endpoint runs on a hardened php-sweph backend with verified Swiss Ephemeris precision.

Predictable JSON · Documented fields

One call. Real numbers.

Every endpoint returns structured JSON with documented fields, not narrative text. Backed by Swiss Ephemeris through our php-sweph extension.

  • Swiss Ephemeris precisionEvery position computed via php-sweph native extension. Sub-arcsecond accuracy.
  • Sub-50ms responsesVPS-hosted, chart-cached, GeoNames pre-indexed. Numerology & panchang return instantly.
  • Decimal lat/lon, IANA TZSigned decimal coordinates and timezone IDs. No deg/min/sec gymnastics required.
  • API key over X-Api-KeyEvery request authenticated via header. Per-key usage logging and rate limits.
POST /api/v2/vedic/natal
// Response
{
  "meta": {
    "endpoint": "/api/v2/vedic/natal",
    "version": "v2.4",
    "ms": 38
  },
  "chart": {
    "ascendant": { "sign": "Cancer",
                    "deg": 12.84,
                    "nakshatra": "Pushya",
                    "pada": 2 },
    "planets": [
      { "name": "Sun",
        "sign": "Cancer", "deg": 22.45,
        "nakshatra": "Ashlesha",
        "house": 1,
        "retrograde": false,
        "dignity": "neutral",
        "shadbala": 412.3 },
      { "name": "Moon",
        "sign": "Pisces", "deg": 8.21,
        "nakshatra": "Uttara Bhadrapada",
        "house": 9,
        "dignity": "friendly" }
    ],
    "yogas_detected": 7,
    "current_dasha": {
      "md": "Jupiter",
      "ad": "Venus",
      "pd": "Sun",
      "ends": "2027-04-14"
    }
  }
}
POST /api/v2/vedic/match/ashta-koota
// Response
{
  "score": { "total": 29.5,
              "max": 36,
              "percentage": 81.9 },
  "compatible": true,
  "recommendation": "Highly recommended",
  "breakdown": [
    { "koota": "Varna",    "score": 1,
      "max": 1, "meaning": "Spiritual" },
    { "koota": "Vasya",    "score": 2,
      "max": 2, "meaning": "Mutual" },
    { "koota": "Tara",     "score": 3,
      "max": 3, "meaning": "Health" },
    { "koota": "Yoni",     "score": 3,
      "max": 4, "meaning": "Sexual" },
    { "koota": "Graha",    "score": 5,
      "max": 5, "meaning": "Friendship" },
    { "koota": "Bhakoot",  "score": 7,
      "max": 7, "meaning": "Emotional" },
    { "koota": "Nadi",     "score": 8,
      "max": 8, "meaning": "Genetic" }
  ],
  "manglik": { "boy": false, "girl": false }
}
POST /api/v2/vedic/vimshottari-dasha
// Response
{
  "birth_balance": {
    "planet": "Moon",
    "years_remaining": 7.42
  },
  "current": {
    "md": { "planet": "Jupiter",
            "start": "2019-08-12",
            "end":   "2035-08-12" },
    "ad": { "planet": "Venus",
            "start": "2025-04-22",
            "end":   "2028-12-22" },
    "pd": { "planet": "Sun",
            "start": "2026-03-08",
            "end":   "2026-09-14" }
  }
}
POST /api/v2/transit/transit-vedic
// Response
{
  "timestamp": "2026-05-10T14:00:00Z",
  "ayanamsa": { "name": "Lahiri",
                "deg": 24.182 },
  "transits": [
    { "planet": "Saturn",
      "sign": "Pisces", "deg": 21.4,
      "nakshatra": "Revati",
      "retrograde": false,
      "natal_house": 8 }
  ],
  "sade_sati": { "active": true,
                  "phase": "peak" }
}
GET /api/v2/horoscope/daily/leo
// Response
{
  "meta": {
    "endpoint": "/api/v2/horoscope/daily/leo",
    "version": "v2.4",
    "lang": "en", "ms": 18
  },
  "sign": { "name": "Leo",
            "element": "Fire",
            "modality": "Fixed",
            "ruler": "Sun" },
  "date": "2026-05-10",
  "overview": "Jupiter trine your Sun energizes
              creative ventures. Lean into bold
              moves at work today.",
  "love":    "Venus in your 7th invites a soft
              conversation with a partner.",
  "career":  "Recognition is likely — say yes
              to the unexpected meeting.",
  "energy":  8.2,
  "moon": { "sign": "Sagittarius",
            "phase": "Waxing Gibbous" },
  "lucky": { "number": 7,
             "color": "Gold",
             "compatible_signs": ["Aries", "Sagittarius"] },
  "active_transits": [
    { "planet": "Jupiter",
      "house": 5,
      "aspect": "Trine Sun" },
    { "planet": "Venus",
      "house": 7,
      "aspect": "Sextile Mars" }
  ]
}
Why builders ship on StarsAPI

Built by an astrologer.
Hardened by traffic.

StarsAPI powers AstroMitra and dozens of white-label apps in production. Every endpoint has been stress-tested against millions of real birth charts.

84

Live endpoints

Across 8 astrological systems. New endpoints ship every month.

38ms

Median response

Native php-sweph + chart caching. Numerology returns under 5ms.

99.9%

Uptime SLA

VPS-hosted with FastPanel + Nginx + Certbot. Failover within minutes.

100%

Documented fields

Every key has a description, type, and example. OpenAPI spec available.

Ready when you are

Ship your astrology
app this weekend.

Plans from $29/mo. All eight domains, the AI astrologers, location autocomplete, and report generation included on every paid tier.

Frequently asked

Questions developers ask before integrating.

What does StarsAPI provide?
A production-ready REST API with 80+ endpoints across Vedic astrology (Jyotish, KP, Lal Kitab, Jaimini), Western astrology, numerology, panchang, transits, AI astrologers, and white-label PDF reports — all under one API key.
Is there a free tier?
Yes. The Free tier lets you evaluate any endpoint without a credit card. Paid plans start at $29/mo and include all 80+ endpoints — no per-product locks.
How accurate are the calculations?
StarsAPI runs on the Swiss Ephemeris (via the native php-sweph extension) — the same engine used by professional astrology software worldwide, with planetary positions accurate to arc-seconds.
Do I get a separate API key for Vedic and Western?
No. One API key gives you full access to every domain — Vedic, Western, numerology, transits, AI astrologers, and reports.
What response times can I expect?
Sub-50ms median for calculation endpoints. AI astrologer and report-generation endpoints take longer because of LLM round-trips.
How does StarsAPI compare to Prokerala, AstrologyAPI, or RoxyAPI?
StarsAPI offers the deepest Vedic stack (full Lal Kitab suite, Jaimini including Mandook Dasha, 57 classical yogas, complete KP) under a flat subscription instead of per-request credits. See our pricing page for a direct feature comparison.