AI Tarot Reading API
This API delivers AI‑generated tarot readings and scripts using a full 78‑card deck (major + minor arcana). Clients can specify the spread (1 or 3 cards), topic (general, love, career, self‑discovery or decision), tone (insightful, blunt, playful) and narrative length (short, medium, long). Every reading returns the drawn cards—including keywords, upright and reversed meanings, orientation…
AI Tarot Reading API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
Get Cards /api/tarot/cards |
Returns an array of all 22 major and 56 minor arcana cards. Each card includes id, name, keywords, upright, reversed, image (path) and image_url (full CDN URL). |
| POST |
Tarot Reading /api/tarot/reading |
Produces an AI‑generated narrative for one or three cards. Validates all parameters and returns topic, tone, length, an array of drawn cards, and the AI‑generated narrative. Each… |
| POST |
Generate Tarot Script /api/tarot/script |
Accepts a set of cards (usually from /reading) and a tone (playful/insightful/blunt), then generates a concise script suitable for video narration. |
| POST |
Generate Multiple Tarot Readings /api/tarot/batch |
Creates multiple tarot readings in one call. Accepts the same parameters as /reading plus count (number of readings to generate). Returns an array of reading objects. Useful for… |
AI Tarot Reading API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1 / second |
|
| PRO | $5 / month | 1 / second |
|
| ULTRA Recommended | $20 / month | 1 / second |
|
| MEGA | $100 / month | 1 / second |
|