AI-Powered Astrology API
for Western & Vedic Astrology.

AI voice and chat astrologers, tarot, numerology, birth charts, transits, synastry, kundli matching, and white-label PDF reports. Access 340+ endpoints with one API key and build astrology apps in days, not months

Integrate into Any Astrology Project.

Sub-arcsecond accuracy
Plans from $29/mo
Median response under 50ms
What you can build

Everything an astrology app sells.
The maths is done.

Kundli to birth chart, kundli matching to synastry, lucky mobile numbers to live AI consultations — all on the same key.

All systems · One key

Nine 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, arcsecond-accurate astronomical backend.

Predictable JSON · Documented fields

One call. Real numbers.

Every endpoint returns structured JSON with documented fields, not narrative text. Backed by an arcsecond-accurate astronomical engine.

  • Arcsecond precisionEvery position computed via our native astronomical 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/v3/vedic/natal/planets
// Response
{
  "status": 200,
  "success": true,
  "data": {
    "ascendant": {
      "longitude": 343.9226,
      "degree_in_sign_dms": "13°55'21\"",
      "sign": "Pisces",
      "sign_lord": "Jupiter",
      "nakshatra": "Uttara Bhadrapada"
    },
    "planets": {
      "Sun": {
        "longitude": 256.8599,
        "longitude_dms": "256°51'36\"",
        "sign": "Sagittarius",
        "sign_hindi": "Dhanu",
        "nakshatra": "Purva Ashadha",
        "house": 10,
        "is_retrograde": false
      }
    }
  },
  "meta": {
    "endpoint": "/api/v3/vedic/natal/planets",
    "version": "3.0",
    "response_time_ms": 11,
    "ayanamsa": { "name": "Lahiri", "value_dms": "23°43'15\"" }
  }
}
POST /api/v3/vedic/matchmaking/ashtakoot
// Response
{
  "status": 200,
  "success": true,
  "data": {
    "summary": {
      "total_points": 29.5,
      "max_points": 36,
      "percentage": 81.9,
      "koots_matched": "4/8",
      "active_doshas": 0,
      "verdict": "Excellent"
    },
    "kutas": [
      {
        "koot": "Yoni",
        "area": "Intimacy",
        "person1": "Mongoose",
        "person2": "Dog",
        "obtained": 2,
        "max": 4,
        "dosha_present": false
      }
    ]
  }
}
POST /api/v3/vedic/dashas/vimshottari
// Response
{
  "status": 200,
  "success": true,
  "data": {
    "dasha_system": "Vimshottari (Parashari)",
    "levels": 2,
    "moon_nakshatra": {
      "name": "Dhanishta",
      "number": 23,
      "lord": "Mars",
      "percentage_traversed": 98.49
    },
    "dasha_at_birth": {
      "balance": "Mars 0 Years, 1 Months, 8 Days",
      "running": "Mars-Moon-Ven-Sun-Ven"
    },
    "current_dasha": {
      "mahadasha": {
        "planet": "Saturn",
        "start_date": "2024-02-09"
      }
    }
  }
}
POST /api/v3/transit/vedic/basic
// Response
{
  "status": 200,
  "success": true,
  "data": {
    "zodiac": "sidereal",
    "ascendant": {
      "longitude_dms": "343°55'21\"",
      "sign": "Pisces",
      "nakshatra": "Uttara Bhadrapada",
      "pada": 4
    },
    "planets": {
      "Sun": {
        "longitude_dms": "256°51'36\"",
        "sign": "Sagittarius",
        "house": 10,
        "daily_motion": 1.019453,
        "is_retrograde": false,
        "is_combust": false
      }
    }
  }
}
POST /api/v3/horoscope/daily
// Response
{
  "status": 200,
  "success": true,
  "data": {
    "sign": "Leo",
    "zodiac_system": "vedic_moon",
    "period_type": "daily",
    "date": "2026-08-02",
    "language": "en",
    "summary": "A day to deepen connections and seek harmony in relationships.",
    "content": "<p>With Chandra in Kumbha today...</p>"
  }
}
Why builders ship on StarsAPI

Built by an astrologer.
Hardened by traffic.

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

340

Live endpoints

Across eight domains. New endpoints ship every month.

<50ms

Median response

Native astronomical engine + chart caching. Numerology returns under 5ms.

99.9%

Uptime

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.

Is there a free astrology API I can try without a credit card?
Yes. The free tier lets you evaluate any endpoint without entering a card, so you can generate a real chart and read the actual response before deciding anything. Paid plans start at $29 a month and include every one of the 340+ endpoints — Vedic, Western, numerology, transits, horoscopes, AI astrologers and reports, with no per-product locks and no credit maths to do in your head.
Which is the best astrology API for a kundli app?
The one that covers more than one school and hands you the reading as well as the numbers. Four Vedic traditions are here — Parashari, KP, Jaimini and Lal Kitab — sharing one JSON contract, so switching school is a parameter rather than a second integration. Doshas arrive as status, analysis and remedies rather than a flag, which is the difference between a chart a developer can render and a product a user will pay for.
How much does an astrology API cost?
Plans start at $29 a month and every plan carries every endpoint — they differ in monthly volume, not in what you are allowed to call. That matters more than it sounds: credit-priced APIs make you predict which features you will build before you have built them. Reports and location lookups are included rather than metered separately.
How do I add astrology to my app or website?
Send birth date, time and place; get JSON back. There is no SDK to adopt and nothing to host — plain HTTPS and documented fields. Place lookup and timezone resolution come with the plan, so a city name is all you need from the user rather than coordinates. Most teams have a working chart screen the same day.
Is there a birth chart API with Placidus and other house systems?
Yes — twenty-three of them, chosen with one request parameter. Placidus by default, plus Koch, Whole Sign, Regiomontanus, Campanus, Equal, Porphyry and the rest, with Ascendant and Midheaven returned for every one. Essential dignity, Arabic parts, fixed stars, antiscia and declinations come with it, which is the layer traditional astrologers check for first.
Is there a synastry API for relationship compatibility?
Yes. Two natal charts are compared across every planetary pair, returning around sixty inter-aspects with exact orb, whether each is tense or harmonious, and its own written reading, plus house overlays both ways. Composite and Davison charts are separate endpoints. On the Vedic side the same job is done by Ashtakoot Guna Milan across all eight kootas.
Can I get transits to a natal chart with exact dates?
Yes — send a birth chart and a date range and every transiting planet that aspects a natal position comes back with when it enters orb, when it is exact and when it leaves. Telling a user what the sky is doing is a free feature on any website; telling them what it is doing to their own chart is the one they subscribe for.
Is there a moon phase API with the next full moon?
Yes. The current phase comes with its illumination percentage and the exact sign and degree the Moon occupies, along with the timing of what comes next. You can trace a whole lunation from the new moon that began it, or pull cycles forward as far as you need, in tropical or sidereal.
Is there a kundli matching API for a matrimony site?
Yes — the full 36-point Ashtakoot across all eight kootas, each returning both parties' values and its own score rather than only a total, with Manglik analysis and cancellation rules. Dashakoot, the South Indian Porutham system, runs separately. There is a branded PDF matching report too, if you would rather hand families a document than a number.
Is there a lucky number calculator numerology API?
Yes, and it is the single most shared feature anyone builds with this. Mobile numbers, vehicle numbers, house and flat numbers, bank accounts, email addresses and signatures each have their own endpoint. Send the number alone for a general reading, or add the owner's date of birth and it becomes specific to them — which is what dealers selling premium numbers use to score their whole stock.
Can I add an AI astrologer to my app?
Yes, in text or in live voice. Named specialists for career, love, transits, health, numerology and Western astrology, each answering from the user's real birth chart rather than from a language model's imagination — the chart is computed before the first reply. Start a session with two charts instead of one and it reads a relationship. Very few products in this category offer that at all.
Can I white-label the API and sell under my own brand?
Yes, completely. Nothing in a response identifies us. PDF reports carry your name, tagline, website and logo on every cover; AI astrologers can be renamed and revoiced for your account; horoscope content can be your own astrologer's copy where you have written it, with ours covering the rest.
How accurate are the calculations?
Planetary longitudes are computed to fractions of an arc-second from the Swiss Ephemeris — what professional astrology software runs on — and returned as decimals and DMS, with the resolved ayanamsa in the meta block of every response. Historical daylight saving is applied automatically from the date and place. An experienced astrologer checks a chart against their own software within minutes of trying an API, which is why this is not a place to economise.
Do I have to handle timezones myself?
No. Send the IANA timezone name with the birth details and the engine resolves the offset that actually applied on that date in that place, going back through the historical rules rather than assuming today's. Place lookup returning coordinates and the timezone is included on every plan, so there is no Google Cloud account, no second key and no separate invoice.
Which languages does the API support?
Horoscope content is live in English and Hindi across daily, weekly, monthly and yearly. The AI astrologers answer in whatever language the user writes or speaks in — there is no list to enable and nothing to configure per language, and they follow a switch mid-conversation.