Tarot API
A tarot API with the full 78-card deck, upright and reversed meanings, a daily card, yes/no readings and single, three-card and Celtic Cross spreads.
Why developers choose it
- All 78 cards with keywords and meanings.
- Reproducible draws with a seed.
- Yes/no answers with reasoning.
What you can build
Endpoints (5)
| Endpoint | What it returns | Credits |
|---|---|---|
| GET /v1/tarot/cards | Full 78-card deck. Filter by ?suit=Major Arcana|Wands|Cups|Pentacles|Swords or keyword search. | 10 |
| GET /v1/tarot/card/{id} | Single card by ID (0–77). Includes upright/reversed meanings, keywords, yes/no tendency. | 10 |
| GET /v1/tarot/daily | Deterministic daily card — same card for all readers on the same date. | 10 |
| GET /v1/tarot/spread | Draw a spread: single (1 card), three (past/present/future), or celtic (10-card Celtic Cross). Seed-reproducible. | 20 |
| GET /v1/tarot/yes-no | Yes/No reading — one card with answer (yes/no/maybe) and reasoning. Seed-reproducible. | 10 |
Frequently asked questions
Is there a free tier?
Yes. Every account gets 1,500 free credits a month with no card required. Paid plans start at ₹999 / $29 a month, and pay-as-you-go is available.
Can AI assistants such as Claude or Cursor call it directly?
Yes. The open-source LifeAstro MCP server exposes every endpoint as a tool for Claude Desktop, Cursor, Codex and other MCP clients that run local servers, using your existing API key.
Which ephemeris and ayanamsa does it use?
Planet positions come from the Swiss Ephemeris. Vedic calculations use the Lahiri (Chitrapaksha) ayanamsa by default; other ayanamsas can be selected per request.
Building an astrology app? 1,500 free API credits a month, no card
Try the Tarot API
Sign up for a free key and make your first call in a minute.
curl -H "Authorization: Bearer $LIFEASTRO_API_KEY" \
"https://api.lifeastroapi.com/v1/tarot/spread?type=three"