WhatsApp · Telegram · AI Agents · MCP

Astrology Chatbot API
for WhatsApp, Telegram & AI Bots

Instant panchang, horoscope, and dasha responses for any chatbot platform. Claude AI narratives ready to send as bot messages. Sub-200 ms for cached users.

Power daily astrology bots, matrimonial screening bots, and AI agents on WhatsApp Business, Telegram, Discord, or any platform — with Swiss Ephemeris accuracy behind every response.

Start free — 500 calls →MCP for AI agents

A complete bot flow in 4 API calls

From raw user input to a personalised AI reading — all in under 1 second for returning users.

1
User sends birth details
Bot collects dob, tob, and city via a conversation flow. The /utilities/geo-search endpoint converts city name → lat/lon/tz automatically.
2
Fetch current dasha
Call /dashas/current-mahadasha to get the user's active Mahadasha, Antardasha, and Pratyantardasha with start and end dates.
3
Fetch today's panchang
Call /panchang/panchang with the user's timezone to get tithi, nakshatra, yoga, karana, and auspicious/inauspicious periods for today.
4
Generate AI narrative
Send birth data to /ai/interpret/chart or /ai/dasha/narrative to get a 600-word Claude AI reading — ready to send as a chatbot message.

Complete chatbot integration — 20 lines

City lookup, dasha fetch, panchang, and AI narrative — all in a single async function.

// Chatbot flow — collect birth data then generate AI response
const BASE = 'https://vedintelastroapi.com/api/v1'
const KEY  = 'vai_YOUR_KEY'

// Step 1: resolve city to coordinates
const geo = await fetch(
  `${BASE}/utilities/geo-search?api_key=${KEY}&city=Mumbai`
).then(r => r.json())
// { lat: 19.0760, lon: 72.8777, tz: 5.5 }

const params = `api_key=${KEY}&dob=01/10/1990&tob=08:30&lat=${geo.response.lat}&lon=${geo.response.lon}&tz=${geo.response.tz}`

// Step 2: fetch current dasha (fast — under 200 ms cached)
const dasha = await fetch(`${BASE}/dashas/current-mahadasha?${params}`).then(r => r.json())

// Step 3: get today's panchang
const panchang = await fetch(`${BASE}/panchang/panchang?${params}&date=25/04/2026`).then(r => r.json())

// Step 4: generate Claude AI narrative to send as bot reply
const ai = await fetch(`${BASE}/ai/dasha/narrative?${params}`).then(r => r.json())

// ai.response.narrative → 600-word reading, ready to send

11 endpoints for bot conversations

Every endpoint is a simple GET request — easy to call from any chatbot framework.

Panchang
/api/v1/panchang/panchang

Full daily panchang — tithi, nakshatra, yoga, karana, sunrise, sunset, auspicious hours

Panchang
/api/v1/panchang/choghadiya-muhurta

Today's Choghadiya auspicious time slots — ideal for daily bot messages

Horoscope
/api/v1/extended-horoscope/find-moon-sign

Moon sign (primary Vedic horoscope sign) for a given birth date

Dasha
/api/v1/dashas/current-mahadasha

Current Mahadasha and Antardasha with remaining duration — fast, concise response

Dasha
/api/v1/dashas/current-mahadasha-full

Full dasha breakdown — Mahadasha → Antardasha → Pratyantardasha tree

Horoscope
/api/v1/horoscope/planet-details

All 9 planets with sign, house, nakshatra, degree, and dignity

Predictions
/api/v1/predictions/daily-moon

Daily horoscope prediction based on moon sign transit

Predictions
/api/v1/predictions/daily-nakshatra

Daily prediction based on today's nakshatra — great for daily push notifications

Utility
/api/v1/utilities/geo-search

City name → lat/lon/timezone lookup. 80+ Indian cities + global coverage

AI
/api/v1/ai/interpret/chart

Claude AI full chart interpretation — 700+ words, ready to send directly as chatbot reply

AI
/api/v1/ai/dasha/narrative

AI narrative for the current Dasha period — what the current cycle means for this person

Everything a production astrology bot needs

Under 200 ms for returning users
Birth charts are cached permanently in Supabase after the first computation. Every subsequent chatbot message for the same user returns in under 200 ms — no user-visible delay.
🤖
MCP server for Claude Desktop agents
The VedIntel™ MCP server exposes all 116 endpoints as tools to Claude agents. Build an autonomous Vedic astrology agent in Claude Desktop with zero custom integration code.
🌐
27 language responses
Add `lang=hi` for Hindi, `lang=ta` for Tamil, `lang=te` for Telugu, and 24 more. The same endpoint, same parameters — localised response text for regional chatbots.
🧭
City autocomplete built in
The /utilities/geo-search endpoint resolves a city name to lat, lon, and timezone. No separate geocoding integration — the bot can collect city name and resolve coordinates in one step.
📅
Daily push content ready
The predictions/daily-moon and daily-nakshatra endpoints return fresh content each day. Schedule a daily job to pre-fetch and broadcast to all your users automatically.
🔒
Rate limits that match bot traffic
From 20 req/sec on Free to 500 req/sec on Enterprise. Burst traffic from notification sends is handled without throttling. Each plan includes a clear quota with top-up packs.

Launch your astrology bot today

500 free API calls to build and test. No credit card required. Scale to millions of users with one environment variable change.

Get free API key →API Docs