Developer Documentation

    AstroAsk API Reference

    Integrate world-class Vedic & Western astrological calculations into your application in minutes. Sub-200ms latency, 21 languages, Swiss Ephemeris precision.

    Quick Start

    Up and running in 60 seconds

    All you need is a RapidAPI key and a birth date. Every endpoint accepts the same base parameters.

    1

    Subscribe on RapidAPI

    Register for a free key on the RapidAPI Hub.

    2

    Set Headers

    Attach X-RapidAPI-Key and host headers to all requests.

    3

    Fetch Live Data

    Query endpoints at vedic-astrology.p.rapidapi.com.

    🔑 Via RapidAPINo self-hosting needed — instant access

    AstroAsk is hosted on RapidAPI. Subscribe to get your key, then attach two headers to every request. No SDK, no install — just HTTP.

    https://vedic-astrology.p.rapidapi.com

    Get Your Free Key

    Free tier included — test immediately without a credit card.

    Two headers only — X-RapidAPI-Key + X-RapidAPI-Host.

    Works with any language — use JavaScript, Python, PHP, cURL, Go, or any HTTP client.

    Subscribe on RapidAPI
    POST /api/v1/kundali
    // Required headers
"X-RapidAPI-Key": "YOUR_KEY"
"X-RapidAPI-Host": "vedic-astrology.p.rapidapi.com"

// Request body
{
"date":     "1990-01-15T10:30:00",
"lat":      28.6139,
"lng":      77.2090,
"timezone": "Asia/Kolkata",
"lang":     "en"   // or "hi", "ta", "ar"…
}
    JSON Response
    {
"success": true,
"data": {
"ascendant": {
"signName":   "Taurus",
"nakshatra":  "Mrigashira",
"degree":     55.47
},
"planets": [ /* 9 planets */ ],
"yogas":   [ /* detected yogas */ ],
"panchanga": { /* 5 limbs */ }
}
}
    const response = await fetch('https://vedic-astrology.p.rapidapi.com/api/v1/kundali', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',
'X-RapidAPI-Host': 'vedic-astrology.p.rapidapi.com'
},
body: JSON.stringify({
date: '1990-01-15T10:30:00',
lat: 28.6139,
lng: 77.2090,
timezone: 'Asia/Kolkata',
lang: 'en'   // Change to 'hi', 'ta', 'ar', etc.
})
});

const chart = await response.json();
console.log(chart.data.ascendant.signName); // "Taurus"
    Interactive Sandbox

    See the Payload in Action

    Configure birth details below and explore the high-fidelity JSON structure. You can also view our public Western Calculators and Vedic Calculators to see these computations rendered visually in real-world consumer interfaces.

    Birth Configuration

    CONFIG_EDITOR
    ▼
    ▼

    Want to make actual API calls? Test live on the RapidAPI Console

    RESPONSE SANDBOX
    {
  "status": "success",
  "data": {
    "ascendant": {
      "signName": "Scorpio",
      "nakshatra": "Anuradha"
    }
  }
}
    API Reference

    All 21 Endpoints

    Every endpoint accepts lang for language selection. POST endpoints use a JSON body; GET endpoints use query parameters.

    🔑
    Base URL: https://vedic-astrology.p.rapidapi.com•Authentication: X-RapidAPI-Key + X-RapidAPI-Host headers.
    Vedic Astrology
    POST
    /api/v1/kundali
    Full birth chart (Rasi) — 9 planets, 12 houses, ascendant, nakshatra, yogas, panchanga, ayanamsa, ashtakavarga. Optional: Navamsa (D-9) and SVG chart image.
    POST
    /api/v1/dasha
    Planetary periods summary — Supports Vimshottari, Yogini, and Ashtottari systems in a single response.
    POST
    /api/v1/dasha/vimshottari
    Detailed Vimshottari Dasha (120-year cycle) with Antardashas and exact timing.
    POST
    /api/v1/yogas
    17+ yoga types detected with 0-100 strength scores — Raj Yoga, Gaja Kesari, Kala Sarpa (12 variants), Pancha Mahapurusha, Mangal Dosha, Neecha Bhanga, and more.
    POST
    /api/v1/transits
    Current planet positions relative to birth chart with Ashtakavarga bindu strength. Includes Sade Sati detection (3 phases, exact dates) and Ashtama Shani.
    GET
    /api/v1/panchanga
    Daily almanac — Tithi, Vara, Nakshatra, Yoga, Karana + Muhurta score (0-100) + birth quality flags. Query params: date, lat, lng, timezone, lang.
    POST
    /api/v1/compatibility
    Kundali Milan — 8-factor Ashtakoota (Varna, Vashya, Tara, Yoni, Grah Maitri, Gana, Bhakut, Nadi) max 36 points. Also supports Western synastry mode.
    POST
    /api/v1/ashtakavarga
    337-point Ashtakavarga bindu system — bindu scores for all 7 classical planets across 12 signs, plus Sarvashtakavarga totals. Use to predict transit strength.
    POST
    /api/v1/shadbala
    6-fold planetary strength — total Rupas score with isStrong flag and all 6 sub-components (Sthana, Dig, Kala, Chesta, Naisargika, Drik Bala).
    Western Astrology
    POST
    /api/v1/western
    Full Western (tropical) natal chart — planet positions with element, modality, dignity, all aspects. Supports Placidus, Koch, Whole Sign, Equal and more house systems.
    POST
    /api/v1/western/chart
    Generates a beautiful circular Western natal chart wheel in inline SVG format. Supports dark/light themes, custom widths/heights, aspects lines, element segment colors, and optional dynamic data tables. Supports format=svg for direct <img> embeds.
    POST
    /api/v1/western/patterns
    Chart pattern detection — Grand Trine, Grand Cross, T-Square, Yod (Finger of God), Stellium. Returns planets involved in each pattern with counts.
    POST
    /api/v1/western/transits
    Western transit analysis — all current transiting planets aspecting natal positions with aspect type, orb, applying/separating status, and interpretation.