Get free key

Tarot API

Card readings: 4 decks, spreads, card encyclopedia, yes/no, daily card, astro-tarot — English JSON with Hindi name twins where available.

Get a free API key Try it in the playground
Test mode

Quick start

Test keys (sk-test-…) are free and unlimited — the response structure is guaranteed identical to production, so you can build your whole integration before paying anything.

Overview first? Read the tarot card API overview: decks, spreads, seeded draws and pricing.

cURL
curl -X POST https://api.grahaapi.com/v1/tarot/astro-tarot \
  -H "Authorization: Bearer sk-test-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_chart": {
      "dob": "1990-06-15",
      "lat": 28.6139,
      "lon": 77.209,
      "tob": "10:30",
      "tz": 5.5
    },
    "deck": "rider_waite",
    "question": "What does my future hold?",
    "spread": "three_card"
  }'
14 endpoints

All Tarot endpoints

POST/v1/tarot/astro-tarot

Map natal planets to their corresponding Tarot Major Arcana.

 GET/v1/tarot/card/{card_id}

Full encyclopedia entry for one card — general / more / reversed / associations tabs.

 GET/v1/tarot/cards

Browse/filter cards — powers an encyclopedia UI. All filters combinable; q searches names.

 POST/v1/tarot/celtic-cross

10-card Celtic Cross spread — comprehensive life reading.

 POST/v1/tarot/daily

Daily card — deterministic based on today's date (same card all day).

 GET/v1/tarot/deck/{deck_name}/cards

List all cards in a specific tarot deck.

 GET/v1/tarot/decks

List all supported tarot decks with metadata.

 POST/v1/tarot/draw

Draw cards for the requested spread type.

 GET/v1/tarot/encyclopedia

Encyclopedia index — browse categories (type, suit, number, court, element, planet, zodiac, symbol, color) with values and card counts.

 POST/v1/tarot/full

Full tarot reading: daily card, three-card spread (past/present/future), and yes/no answer.

 POST/v1/tarot/interpretation

Detailed interpretation of a specific card by name or ID.

 POST/v1/tarot/single

Single card reading — focused answer to a question.

 POST/v1/tarot/three-card

Past / Present / Future three-card spread.

 POST/v1/tarot/yes-no

Yes/No tarot reading based on drawn card.
FAQ

Frequently asked questions

Full interactive reference for all 237 endpoints: GrahaAPI Docs · Plain-language explainers: Wiki

What does the Tarot API return?

Card readings: 4 decks, spreads, card encyclopedia, yes/no, daily card, astro-tarot. Every response is JSON ({success, data, meta}); names come with Hindi twins where available (e.g. "sign": "Leo", "sign_hi": "सिंह"). This module has 14 endpoints.

Can I try the Tarot API for free?

Yes — sk-test- keys are free and unlimited, and return the exact production response structure (computed from a fixed sample input). The Free plan then gives 1,000 real API calls per month with no credit card.

How is GrahaAPI priced?

Simple INR pricing: Free (1,000 calls/mo), then paid plans from ₹499/mo. One call = one call on every endpoint — no credit system, no overage bills. When a plan's monthly limit is used up, calls pause until the 1st (or until you upgrade).

Time to bring the cosmos into your app.

Start free. No credit card. API key in under 1 minute.

Get free API key View pricing