Taro’s Tarot · Open data · Version 1.0.0
Free tarot card data for all 78 cards
Names, numbers, suits, keywords, upright and reversed meanings, yes or no answers, elements and astrology for every card in the tarot, in one file you can use in an app, a spreadsheet or a website. Each card has a public-domain image from the 1909 Rider-Waite-Smith deck and a link to its full meaning. Free to use, including commercially, with a credit link.
What each card includes
| Field | What it holds |
|---|---|
| id, name | URL slug and card name, e.g. the-fool, The Fool |
| number | Major Arcana 0-21; minor cards 1-14 (ace 1 ... ten 10, page 11, knight 12, queen 13, king 14) |
| arcana, suit, rank | major or minor; wands, cups, swords or pentacles; ace to king (empty for the Major Arcana) |
| keywords | Eight keywords per card |
| upright, reversed | The upright and reversed meaning, one sentence each |
| yes_no | Yes, no or maybe for the card upright and reversed, with a one-line reason |
| element | Fire, water, air or earth |
| astrology | Planet and sign (Major Arcana and cards 2-10), decan and zodiac dates where the card has them, elemental dignity for court cards |
| image, url | The card image on our CDN and the card’s full meaning page |
The CSV has the same data in 20 columns, one row per card, with keywords separated by semicolons. The meanings are the short forms of the ones on each card’s page; the card meanings guide has the full text, and the yes or no guide explains every yes/no answer.
Example: The Fool
{
"id": "the-fool",
"name": "The Fool",
"number": 0,
"arcana": "major",
"suit": null,
"rank": null,
"keywords": [
"new beginnings",
"innocence",
"spontaneity",
"free spirit",
"adventure",
"faith",
"potential",
"risk"
],
"upright": "New beginnings, unlimited potential, and a leap of faith into the unknown.",
"reversed": "Recklessness, poor judgment, or fear of taking necessary risks.",
"yes_no": {
"upright": "yes",
"reversed": "no",
"summary": "A yes for the leap itself; the landing is not shown yet"
},
"element": "air",
"astrology": {
"planet": "Uranus",
"sign": "Aquarius",
"decan": null,
"dates": null,
"elemental_dignity": null
},
"image": "https://cdn.tarostarot.com/cards/00-TheFool.webp",
"url": "https://tarostarot.com/tarot-cards/the-fool"
}Use it in your code
The files answer requests from any website, so browser code can read them directly. There is no key and no rate limit; fetch the file once and keep a copy.
const res = await fetch('https://tarostarot.com/tarot-card-data/tarot-cards.json');
const { cards } = await res.json();
const card = cards[Math.floor(Math.random() * cards.length)];
console.log(card.name, card.upright, card.yes_no.upright);Public-domain card images
The ZIP holds the 78 card images the site uses (WebP, 300 × 527 pixels, named as in the image field). They are scans of the original Rider-Waite-Smith deck, drawn by Pamela Colman Smith to A. E. Waite’s instructions and published by William Rider & Son in London in 1909. The scans are Holly Voley’s, as uploaded to Wikimedia Commons in 2008; we added the black frame. They are not the 1971 U.S. Games recolouring, which has its own copyright.
The artwork is in the public domain: it was published in 1909, and Smith died in 1951, so UK and EU copyright ended on 1 January 2022. You may use the images for anything. For larger scans of a 1910 printing, see the Wikimedia Commons set. Rider-Waite is a trademark of U.S. Games Systems, Inc.; the name is used here only to say which deck the scans come from.
Put the daily card on your site
Paste this where the card should appear. It shows today’s card of the day with its image, name and upright meaning, and changes at midnight UTC. One script (21 KB, cached by browsers for a day); no cookies, no tracking, no ads. The link under the card stays: the script puts it back if it is removed.
<div data-taros-tarot-daily-card><a href="https://tarostarot.com/tarot-card-of-the-day">Daily card by Taro's Tarot</a></div>
<script src="https://tarostarot.com/embed/daily-card.js" async></script>For a dark card, add data-theme="dark" to the div. On a single-page app, call TarosTarotDailyCard.render() after adding the div.
Licence and credit
The card data is free to use, including in commercial projects, under the Creative Commons Attribution 4.0 licence. Credit Taro’s Tarot with a link to this page, for example:
Tarot card data by <a href="https://tarostarot.com/tarot-card-data">Taro's Tarot</a> (CC BY 4.0)The card images are public domain and need no credit. The same files, with a README, are in the tarot-card-data repository on GitHub. Data version 1.0.0, updated 2026-11-12.
Questions
About the data, the images and the embed
Is there a free tarot card API?
Are the Rider-Waite tarot card images public domain?
Can I use the tarot card data in a commercial app?
Which card does the daily card embed show?
Still have questions? We're here to help!
Contact Support →