Vedika API — Use Cases & Examples

Conversational AI

WhatsApp Astrology Bot

Problem

Users want to ask astrology questions in natural language via WhatsApp, without learning astrological terminology or navigating complex forms.

Solution with Vedika

Use the AI chat endpoint to accept plain-language questions. Users send their birth details once, then ask unlimited follow-up questions. The AI understands context from previous messages in the conversation. Supports 30 languages including Hindi, Tamil, Telugu, and Hinglish.

Endpoints Used

POST /api/vedika/chat POST /api/vedika/chat/stream (SSE)

Sample Request

POST https://api.vedika.io/api/vedika/chat
{
  "question": "Will I get a promotion this year?",
  "birthDetails": {
    "datetime": "1992-08-14T06:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "+05:30"
  },
  "language": "en"
}

Response (excerpt)

{
  "success": true,
  "response": "Your 10th house lord Saturn is currently in its own sign Aquarius,
    which strengthens career prospects. The ongoing Jupiter-Saturn Mahadasha-Antardasha
    period (2025-2027) is particularly favorable for professional advancement..."
}

Matchmaking

Marriage Matching App

Problem

Matrimonial platforms need to show Ashtakoota compatibility scores between profiles automatically, including Mangal Dosha checks and detailed breakdown of all 8 matching criteria.

Solution with Vedika

Call the Guna Milan endpoint with both partners' birth data. Get a 36-point compatibility score with individual scores for all 8 criteria (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi). Run Mangal Dosha check separately for each partner.

Endpoints Used

POST /v2/astrology/guna-milan POST /v2/astrology/mangal-dosha

Sample Request

POST https://api.vedika.io/v2/astrology/guna-milan
{
  "partner1": {
    "datetime": "1992-03-15T08:00:00",
    "latitude": 19.0760, "longitude": 72.8777, "timezone": "+05:30"
  },
  "partner2": {
    "datetime": "1994-07-22T14:30:00",
    "latitude": 28.6139, "longitude": 77.2090, "timezone": "+05:30"
  }
}

Response (excerpt)

{
  "totalScore": 28,
  "maxScore": 36,
  "recommendation": "Highly Compatible",
  "criteria": {
    "varna": { "score": 1, "maxScore": 1 },
    "vashya": { "score": 2, "maxScore": 2 },
    "tara": { "score": 3, "maxScore": 3 },
    "yoni": { "score": 3, "maxScore": 4 },
    "grahaMaitri": { "score": 5, "maxScore": 5 },
    "gana": { "score": 6, "maxScore": 6 },
    "bhakoot": { "score": 7, "maxScore": 7 },
    "nadi": { "score": 1, "maxScore": 8 }
  }
}

Content

Daily Horoscope Feed

Problem

News apps and media sites need daily horoscope content for all 12 zodiac signs, refreshed every morning, in multiple languages.

Solution with Vedika

Set up a cron job that calls the horoscope endpoint for each sign at midnight. Cache responses for 24 hours. Vedika generates unique content daily based on actual planetary transits, not recycled generic text. Available in 30 languages.

Endpoints Used

GET /v2/western/horoscope/:sign POST /v2/astrology/panchang

Sample Request

GET https://api.vedika.io/v2/western/horoscope/aries
Headers: x-api-key: vk_live_your_key

Charts

Kundli Generation Tool

Problem

Professional astrology software needs to generate complete birth charts with planetary positions, house cusps, nakshatras, divisional charts, and strength analysis from birth data.

Solution with Vedika

A single call to the kundli endpoint returns the complete birth chart: all 9 planets with signs, houses, degrees, nakshatras, and dignities. Chain additional calls for divisional charts (Navamsa D9, Dasamsa D10), Shadbala strength, and Vimshottari Dasha periods.

Endpoints Used

POST /v2/astrology/kundli POST /v2/astrology/divisional-charts POST /v2/astrology/vimshottari-dasha POST /v2/astrology/shadbala

Sample Request

POST https://api.vedika.io/v2/astrology/kundli
{
  "datetime": "1985-12-25T04:15:00",
  "latitude": 12.9716,
  "longitude": 77.5946,
  "timezone": "+05:30"
}

Alerts

Transit Alert System

Problem

Users want notifications when major planetary transits affect their birth chart — Saturn return, Jupiter transit through key houses, Sade Sati start/end, retrograde periods.

Solution with Vedika

Poll the transit endpoint daily for each user's birth chart. Compare current transit positions against natal chart houses. Trigger push notifications when Saturn enters the user's 12th/1st/2nd house from Moon (Sade Sati), Jupiter enters key houses, or major planets go retrograde.

Endpoints Used

POST /v2/astrology/transits POST /v2/astrology/sade-sati

Sample Request

POST https://api.vedika.io/v2/astrology/sade-sati
{
  "datetime": "1990-06-15T10:30:00",
  "latitude": 19.0760,
  "longitude": 72.8777,
  "timezone": "+05:30"
}

E-commerce

Gemstone Recommender

Problem

Spiritual e-commerce stores want to recommend gemstones based on each customer's actual birth chart, not generic sun sign recommendations.

Solution with Vedika

Call the planetary strength (Shadbala) endpoint to identify weak planets. Map weak planets to recommended gemstones per BPHS prescriptions: Ruby for weak Sun, Pearl for Moon, Red Coral for Mars, etc. Display personalized recommendations on the product page alongside the matching products.

Endpoints Used

POST /v2/astrology/shadbala POST /v2/astrology/dosha POST /api/vedika/chat (AI remedies)

Sample Request

POST https://api.vedika.io/v2/astrology/shadbala
{
  "datetime": "1995-09-10T16:00:00",
  "latitude": 23.0225,
  "longitude": 72.5714,
  "timezone": "+05:30"
}