Tarot AI Reading
Transform your app with **authentic tarot readings** powered by advanced AI. Our API delivers meaningful, personalized interpretations using the classic **78-card Rider-Waite deck**.
Tarot AI Reading endpoints
| Method | Endpoint | Description |
|---|---|---|
| api | ||
| POST |
v2WeeklyReading /api/v2/weekly |
Seven card spread with guidance for each day of the week, in any supported language. **Credits: 5** **Days & Themes:** - Monday: Career & Goals - Tuesday: Relationships & Love -… |
| POST |
v2SingleCardReading /api/v2/single-card |
Draw a single tarot card for quick guidance on any topic, in any supported language, with deterministic fallback on AI failure. **Credits: 1** |
| POST |
v2YesNoReading /api/v2/yes-no |
Get a yes, no, or maybe answer to a specific question with explanation, in any supported language. Fallback derives the answer from the card's orientation (upright -> Yes,… |
| POST |
v2RelationshipReading /api/v2/relationship |
Five card spread focused on relationship dynamics, in any supported language. **Credits: 3** **Positions:** 1. Your Energy 2. Their Energy 3. The Dynamic 4. The Challenge 5. The… |
| POST |
v2LifePurposeReading /api/v2/life-purpose |
Five card spread for discovering your life's purpose and mission, in any supported language. **Credits: 3** **Positions:** 1. Your Essence 2. Your Talents 3. Your Mission 4. Your… |
| POST |
v2ThreeCardReading /api/v2/three-card |
Classic three card spread with multiple layout options, in any supported language. **Credits: 2** **Available Spreads:** - Past-Present-Future - Mind-Body-Spirit -… |
| POST |
v2ShadowWorkReading /api/v2/shadow-work |
Five card spread for exploring your shadow self and personal growth, in any supported language. **Credits: 3** **Positions:** 1. The Hidden Self 2. The Trigger 3. The Lesson 4.… |
| POST |
v2CelticCrossReading /api/v2/celtic-cross |
The most comprehensive tarot spread with 10 cards covering all aspects of a situation, in any supported language. **Credits: 4** **Positions:** 1. Heart of the Matter 2. Crossing… |
| Other endpoints | ||
| POST |
threeCardReading /api/three-card |
Classic three card spread with multiple layout options. **Credits: 2** **Available Spreads:** - Past-Present-Future - Mind-Body-Spirit - Situation-Action-Outcome - What-Why-How -… |
| POST |
shadowWorkReading /api/shadow-work |
Five card spread for exploring your shadow self and personal growth. **Credits: 3** **Positions:** 1. The Hidden Self 2. The Trigger 3. The Lesson 4. The Gift 5. Path to… |
| GET |
healthCheck /api/health |
Check API status and available services with credit costs |
| POST |
weeklyReading /api/weekly |
Seven card spread with guidance for each day of the week. **Credits: 5** **Days & Themes:** - Monday: Career & Goals - Tuesday: Relationships & Love - Wednesday: Communication &… |
| POST |
relationshipReading /api/relationship |
Five card spread focused on relationship dynamics. **Credits: 3** **Positions:** 1. Your Energy 2. Their Energy 3. The Dynamic 4. The Challenge 5. The Potential |
| POST |
singleCardReading /api/single-card |
Draw a single tarot card for quick guidance on any topic. Perfect for daily draws or quick questions. **Credits: 1** |
| POST |
celticCrossReading /api/celtic-cross |
The most comprehensive tarot spread with 10 cards covering all aspects of a situation. **Credits: 4** **Positions:** 1. Heart of the Matter 2. Crossing Factor 3. Foundation 4.… |
| POST |
lifePurposeReading /api/life-purpose |
Five card spread for discovering your life's purpose and mission. **Credits: 3** **Positions:** 1. Your Essence 2. Your Talents 3. Your Mission 4. Your Challenge 5. Your Ultimate… |
| POST |
yesNoReading /api/yes-no |
Get a yes or no answer to a specific question with explanation. **Credits: 1** |
| POST |
shadowWorkReading /api/shadow-work |
Five card spread for exploring your shadow self and personal growth. **Credits: 3** **Positions:** 1. The Hidden Self 2. The Trigger 3. The Lesson 4. The Gift 5. Path to… |
| POST |
yesNoReading /api/yes-no |
Get a yes or no answer to a specific question with explanation. **Credits: 1** |
| POST |
weeklyReading /api/weekly |
Seven card spread with guidance for each day of the week. **Credits: 5** **Days & Themes:** - Monday: Career & Goals - Tuesday: Relationships & Love - Wednesday: Communication &… |
| POST |
lifePurposeReading /api/life-purpose |
Five card spread for discovering your life's purpose and mission. **Credits: 3** **Positions:** 1. Your Essence 2. Your Talents 3. Your Mission 4. Your Challenge 5. Your Ultimate… |
| POST |
relationshipReading /api/relationship |
Five card spread focused on relationship dynamics. **Credits: 3** **Positions:** 1. Your Energy 2. Their Energy 3. The Dynamic 4. The Challenge 5. The Potential |
| POST |
singleCardReading /api/single-card |
Draw a single tarot card for quick guidance on any topic. Perfect for daily draws or quick questions. **Credits: 1** |
| GET |
healthCheck /api/health |
Check API status and available services with credit costs |
| POST |
celticCrossReading /api/celtic-cross |
The most comprehensive tarot spread with 10 cards covering all aspects of a situation. **Credits: 4** **Positions:** 1. Heart of the Matter 2. Crossing Factor 3. Foundation 4.… |
| POST |
threeCardReading /api/three-card |
Classic three card spread with multiple layout options. **Available Spreads:** - Past-Present-Future - Mind-Body-Spirit - Situation-Action-Outcome - What-Why-How - Love Triangle… |
Tarot AI Reading pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $2.99 / month | — |
|
| ULTRA | $20.99 / month | — |
|
| MEGA | $200 / month | — |
|