Digital Divination

Tarot Card API

Integrate the complete 78-card Rider-Waite-Smith deck into your application. Generate randomized spreads, retrieve deep upright and reversed meanings, and access high-resolution card imagery instantly.

Get API Key Read Documentation →
Response: /v1/tarot/draw?spread=past-present-future 
{
  "spread": "Past, Present, Future",
  "cards": [
    {
      "position": "Past",
      "name": "The Fool",
      "arcana": "Major",
      "orientation": "Upright",
      "meaning": "Beginnings, innocence, spontaneity, a free spirit.",
      "image_url": "https://cdn.planetsxp.com/tarot/rws/the_fool.jpg"
    }
  ]
}

78 Cards

Complete RWS Deck

Reversals

Upright & Reversed Logic

Pre-built

Celtic Cross & Spreads

CDN Hosted

High-Res Card Assets

Built for Spiritual Apps

Power your daily draws, interactive readings, and educational tarot directories seamlessly.

Automated Spreads

Draw cards using built-in spread logic including Single Card, Past-Present-Future, Career Path, and the 10-card Celtic Cross.

Upright & Reversed

The drawing engine accurately simulates physical shuffling. You can enable or disable reversed cards with a simple boolean parameter.

Hosted Image Assets

Every API response includes a fast, CDN-hosted URL to a high-resolution, restored image of the Rider-Waite-Smith card.

Deep Interpretations

Retrieve deep metadata for every card, including numerology, planetary associations, element, and detailed paragraphs for love and career.

Yes / No Oracle

Access a dedicated endpoint for quick "Yes or No" questions. It draws a single card and provides a definitive answer based on the card's energy.

Daily Global Draw

Use the "Card of the Day" endpoint to ensure every user on your platform sees the exact same daily card, perfect for community apps.

Predictable Endpoints

Effortlessly pull cards, spreads, and metadata with simple REST commands.

GET /v1/tarot/draw

Draw Random Cards

The core endpoint for interactive readings. Specify the number of cards to pull, whether to allow reversals, and if you want to apply a specific named spread format.

Query Parameters
?count=3
&reversals=true
&spread=past_present_future
GET /v1/tarot/cards/{id}

Detailed Card Metadata

Fetch the complete encyclopedia entry for a specific card. Perfect for building Tarot dictionaries and educational directories within your application.

JSON Response (Snippet)
"metadata": {
  "name": "Death",
  "number": 13,
  "arcana": "Major",
  "element": "Water",
  "astrology": "Scorpio",
  "description": "The Death card represents the end of a major phase..."
}

Frequently Asked Questions

Everything you need to know about integrating our Tarot Card API.

What is the Tarot Card API?
The Tarot Card API by PlanetsXP is a developer tool that allows you to easily integrate tarot card readings, card meanings, and high-quality images into your apps or websites using standard REST JSON requests.
Does the tarot api support both Major and Minor Arcana?
Yes, our tarot api includes the complete traditional 78-card Rider-Waite-Smith deck. This covers all 22 Major Arcana cards (like The Fool and The World) and all 56 Minor Arcana cards across the four suits (Wands, Cups, Swords, and Pentacles).
Can I draw reversed cards using the tarot api?
Absolutely. The drawing engine allows you to enable or disable reversals. When enabled, the API randomly determines if a card is pulled upright or reversed, and automatically returns the correct orientation-specific meaning in the JSON response.
What spreads are available in the tarot card api?
You can request a raw number of cards (e.g., draw 3 cards), or you can use our built-in spread parameter. Available spreads include the Single Card, Past-Present-Future, Mind-Body-Spirit, and the complex 10-card Celtic Cross. The API maps the drawn cards to their specific positional meanings.
Does the API provide card images?
Yes. Every card object returned by the API includes a direct `image_url` link pointing to our fast, globally distributed CDN. This allows you to display beautiful, restored Rider-Waite-Smith card images in your UI without having to host the image files yourself.
How do I build a Daily Tarot app with this?
You can use our specific `/v1/tarot/daily` endpoint. This acts as a global daily tarot api, ensuring that if you want a community experience, every user hitting your app on that calendar day sees the same "Card of the Day". Alternatively, you can use the standard draw endpoint for individualized daily pulls.
Are the card interpretations customizable?
While the API provides extensive default interpretations (general meaning, love, career, and finances), you can easily pair our Tarot API with our Astro AI engine to generate highly customized, dynamic readings based on the user's specific question.
Does it provide astrological associations for cards?
Yes. For developers building hybrid astrology-tarot apps, the API metadata includes the exact planetary ruler, zodiac sign, elemental association (Fire, Earth, Air, Water), and numerological value for every single card in the deck.
Is there a Yes/No tarot api endpoint?
Yes, we have a dedicated `/v1/tarot/oracle` endpoint designed specifically for Yes/No questions. It draws a single card and evaluates its inherent energy (positive, negative, or neutral/maybe) to provide a definitive short answer to the user.
How fast is the random tarot card api response?
Our random tarot card api utilizes a secure, cryptographically random generation algorithm that operates entirely in memory on our edge servers. Responses, including the JSON data and CDN image links, are typically returned in under 50 milliseconds.

Ready to integrate Tarot cards?

Start building your divination application today. Get up to 1,000 free API calls per month in our sandbox environment.

Get Free API Key View Docs