The Vedika Tarot API draws cards and returns the reading as structured JSON: a single card or yes/no draw, three-card, Celtic Cross, horseshoe, love, career, decision and other spreads, a card of the day, major and minor arcana lookups, and AI interpretation of a draw.
It is part of the Vedika astrology API, so the same key and wallet also cover charts and readings. The astro-tarot fusion route combines tarot with astrology, and the draw routes accept an optional seed so the same seed repeats the same draw.
| Endpoint | Returns |
|---|---|
GET /v2/tarot/card-of-the-day | Tarot Card of the Day |
POST /v2/tarot/draw/single | Single Card Draw |
POST /v2/tarot/draw/three-card | Three Card Spread |
POST /v2/tarot/draw/celtic-cross | Celtic Cross Spread |
POST /v2/tarot/draw/love | Love Spread |
POST /v2/tarot/draw/career | Career Spread |
POST /v2/tarot/draw/yes-no | Yes/No Tarot Reading |
POST /v2/tarot/ai-interpretation | AI Tarot Interpretation |
POST /v2/tarot/astro-fusion | Astro-Tarot Fusion |
POST /v2/tarot/compatibility | Tarot Compatibility Reading |
GET /v2/tarot/spreads | List Available Spreads |
GET /v2/tarot/cards/major-arcana | Major Arcana Cards |
GET /v2/tarot/card/{name} | Card Lookup |
There are also horseshoe, decision, chakra, past-life, spiritual, weekly, monthly and custom spreads, and lookups by suit, element and zodiac sign. The API reference lists every route.
Send a question and, optionally, a seed for a repeatable draw. Auth is a Bearer API key. The keyless sandbox mirrors the production routes.
curl -X POST https://api.vedika.io/v2/tarot/draw/three-card \
-H "Authorization: Bearer vk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What should I focus on this week?"}'See the quickstart and the API reference.
Self-serve plans are Starter $12/month, Professional $60/month, Business $120/month and Enterprise $240/month. Flagship is custom-priced by contract. AI answers are priced per query and vary with the request; each response reports the amount charged. There is no free production tier, and the sandbox is a mock. Accounts that have never paid can start one 14-day Professional trial. Terms are on the pricing page.
Use it for daily-card features, reading apps, relationship and decision tools and spiritual-wellness products. For other oracle systems see the Oracles and Divination API; for the I Ching see the I Ching API.
It draws single cards and spreads (three-card, Celtic Cross, love, career, decision and others), returns a card of the day, looks up major and minor arcana cards, and offers AI interpretation and an astro-tarot fusion reading, all as structured JSON.
GET /v2/tarot/spreads lists the available spreads. The draw routes include single, three-card, Celtic Cross, horseshoe, love, relationship, career, decision, chakra, past-life, spiritual, weekly, monthly, yes/no and custom.
Yes. The draw routes accept an optional seed, and the same seed gives the same draw. That is useful for testing and for sharing a reading.
Yes. A keyless mock sandbox at vedika.io/sandbox mirrors production routes, so you can call it with no API key. There is no free production tier. Accounts that have never paid can start one 14-day Professional trial: you authorise the Professional auto-debit and receive $5 of credit that ends with the trial. Nothing is charged for the plan on day 0, and Professional ($60/month, plus GST in India) is charged on day 14 unless you cancel at least 48 hours before the trial ends.
Self-serve plans are Starter $12/month, Professional $60/month, Business $120/month and Enterprise $240/month; Flagship is custom-priced by contract. AI answers are priced per query and vary with the request, and every response reports the exact amount charged. Current limits are on vedika.io/pricing.
Astrology API · Oracles and Divination API · I Ching API · Daily Content API · Numerology API · Documentation · API reference · Pricing