Welcome to Divine API Documentation

Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text

Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Astrology, tarot, numerology, and horoscope APIs for developers. 193 endpoints, 8 languages, one platform. No domain expertise required.

Get Started in 3 Steps

Get your API key — divineapi.com/api-keys (instant, no approval needed)
Make your first call — Copy and run:

curl -X POST https://astroapi-5.divineapi.com/api/v5/daily-horoscope -H "Authorization: Bearer YOUR_AUTH_TOKEN" -d "api_key=YOUR_API_KEY&sign=aries&day=21&month=3&year=2026&tzone=5.5&h_day=today"

Get JSON back — You'll receive a response like:

{
  "success": 1,
  "data": {
    "sign": "aries",
    "prediction": {
      "personal": "Today brings a surge of creative energy...",
      "health": "Focus on maintaining balance...",
      "profession": "A new opportunity may arise...",
      "emotions": "Your emotional intelligence peaks...",
      "travel": "Short trips are favored...",
      "luck": "Lucky number: 7, Lucky color: Red"
    }
  }
}

What Do You Want to Build?

Make my first API call — Daily Horoscope quickstart
Use with AI (Claude, ChatGPT, Gemini) — MCP Server setup
Use our SDK (JS / Python / PHP) — SDKs & Libraries
Build a Kundli / birth chart app — Indian Vedic API
Add Western astrology — Natal charts, synastry, transits
Generate PDF reports — White-label Kundli & match making reports

What Can You Build?

Astrology chatbot — Connect via MCP to Claude/ChatGPT for instant astrology answers
Daily horoscope widget — Embed horoscope predictions on any website or app
Kundli / birth chart generator — Full Vedic charts with planetary positions & dashas
Compatibility matching app — Ashtakoot Milan, synastry, love compatibility
Numerology calculator — Name number, life path, Lo Shu grid analysis
PDF report service — White-label Kundli reports, match making, yearly predictions

API Categories

Category	What It Covers	Endpoints
Horoscope & Tarot	Daily/weekly/monthly horoscopes, tarot readings, fortune cookie, angel readings	20+
Indian / Vedic API	Kundli, planetary positions, dashas, panchang, matching, yogas	80+
Western Astrology	Natal charts, synastry, transits, progressions, fixed stars	50+
Lifestyle APIs	Love readings, career guidance, dream interpretation	15+
Numerology	Core numbers, Lo Shu grid, name analysis, mobile number analysis	15+
PDF Reports	Kundli Sampoorna, match making, yearly predictions, numerology reports	10+
Calculators	Love calculator, FLAMES, zodiac compatibility tools	5+

Official SDKs

Language	Install
JavaScript / TypeScript	`npm install divineapi`
Python	`pip install divineapi`
PHP	`composer require divineapi/divineapi`

Full SDK documentation →

Helpful Links

Get API Keys: divineapi.com/api-keys
Support Articles: support.divineapi.com
Postman Collection: View on Postman
MCP Integration: Connect to Claude, ChatGPT, Gemini
Timezone Guide: Understanding Time Zones