🃏 Yu-Gi-Oh! Card Database Scraper

🚀 Pull Yu-Gi-Oh! cards with attack, defense, level, type, attribute, race, archetype, ban list status, set listings, and prices across 5 markets.

🕒 Last updated: 2026-05-08 · 📊 28+ fields per record · 13K+ Yu-Gi-Oh! cards · 30 card types · 8 attributes · 34 races · 638 archetypes · TCG / OCG / Goat ban lists · prices on Cardmarket, TCGPlayer, eBay, Amazon, Coolstuffinc

The Yu-Gi-Oh! Card Database Scraper pulls full card metadata from the YGOProDeck open community database. Output includes card image (full + small + cropped + gallery for alternate arts), card ID, name, type, typeline, frame type, description, attack / defense / level / link value / link markers / pendulum scale, race, attribute, archetype, ban list status (TCG / OCG / Goat), set listings (set name + code + rarity + price), and prices across 5 markets: Cardmarket, TCGPlayer, eBay, Amazon, Coolstuffinc.

Filter by name, type, race, attribute, archetype, or ban list. The race + archetype fields are full enums (34 races + 638 archetypes), so the schema validates input and the user gets dropdowns instead of free-text guessing.

🎯 Target Audience	💡 Primary Use Cases
TCG players, deck-builders, card-shop owners, ML researchers, fan-app developers, content creators	Deck-builder UIs, price-tracking tools, fan-app card databases, archetype-discovery, ML on card art and stats

---

📋 What the Yu-Gi-Oh! Card Database Scraper does

Five filtering workflows in a single run:

• 🔍 Filter by name. Substring or full-name match.
• 🏷️ Filter by type. 30 card types: Effect Monster, Spell Card, Trap Card, Synchro, XYZ, Link, etc.
• ⚔️ Filter by attribute or race. 8 attributes (DARK / LIGHT / WATER / FIRE / EARTH / WIND / DIVINE) and 34 races (Dragon, Spellcaster, Warrior, etc) as full enums.
• 🏷️ Filter by archetype. 638 archetypes as a full enum (Blue-Eyes, Dark Magician, Six Samurai, etc).
• ⚖️ Filter by ban list. TCG (Western), OCG (Asian), or Goat Format.

💡 Why it matters: clean, server-side filtering and fresh data on every run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan up to 1,000,000.
name	string	""	Card name substring or full match. Empty = any.
type	string	""	Card type enum (30 values). Empty = any.
race	string	""	Race enum (34 monster races + spell / trap kinds). Empty = any.
attribute	string	""	Attribute enum (DARK, LIGHT, EARTH, WATER, FIRE, WIND, DIVINE). Empty = any.
archetype	string	""	Archetype enum (638 values: Blue-Eyes, Dark Magician, Six Samurai, etc). Empty = any.
banlist	string	""	Ban list (tcg, ocg, goat). Empty = any.

Example: every Blue-Eyes card.

{
    "maxItems": 100,
    "archetype": "Blue-Eyes"
}

Example: all DARK Synchro Monsters.

{
    "maxItems": 100,
    "type": "Synchro Monster",
    "attribute": "DARK"
}

---

📊 Output

Each record contains 28+ fields. Download as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🖼️ imageUrl	string	"https://images.ygoprodeck.com/images/cards/46986414.jpg"
🖼️ imageUrlSmall	string	"https://images.ygoprodeck.com/images/cards_small/46986414.jpg"
🆔 cardId	number	46986414
📛 name	string	"Dark Magician"
🏷️ type	string	"Normal Monster"
🏷️ typeline	array	["Spellcaster","Normal"]
📜 description	string	"The ultimate wizard in terms of attack and defense."
⚔️ atk	number	2500
🛡️ def	number	2100
⭐ level	number	7
🌐 race	string	"Spellcaster"
🌌 attribute	string	"DARK"
🏷️ archetype	string	"Dark Magician"
⚖️ banlistTcg	string	"Unlimited"
⚖️ banlistOcg	string	"Unlimited"
📦 sets	array of objects	[{"name":"Legend of Blue Eyes White Dragon","code":"LOB-005","rarity":"Ultra Rare","rarityCode":"(UR)","price":"42.00"}]
📊 setCount	number	124
💰 cardmarketPrice	number	2.45
💰 tcgplayerPrice	number	3.21
💰 ebayPrice	number	4.99
💰 amazonPrice	number	5.50
💰 coolstuffincPrice	number	3.99
🌐 ygoproUrl	string	"https://db.ygoprodeck.com/card/?search=Dark%20Magician"

📦 Sample records

---

✨ Why choose this Actor

	Capability
🏷️	Full enums. Race (34) and archetype (638) are dropdowns - no guessing slugs.
💰	5-market prices. Cardmarket, TCGPlayer, eBay, Amazon, Coolstuffinc all in one record.
📦	Full set history. Every printing with set name, code, rarity, and price.
⚖️	Triple ban list. TCG, OCG, and Goat Format status side-by-side.
🆓	No auth. YGOProDeck is open.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ This Actor	$5 free credit	13K+ cards	Live per run	6 filters	⚡ 1 min
YGOProDeck API	Free	Same	Live	DIY	🐢 Code
yugiohprices	Free	Same	Live	Limited	🐢 Account
Manual scraping	Free	All	Live	DIY	🐢 Days

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Find the Yu-Gi-Oh! Card Database Scraper on the Apify Store.
3. 🎯 Set input. Pick filters and maxItems.
4. 🚀 Run it. Click Start.
5. 📥 Download. Grab results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

🃏 Deck-Building + Apps Deck-builder UIs with filters Card-search engines Fan-app databases Trade evaluators	💰 Price Tracking + Investing Price-tracking dashboards Multi-market arbitrage Investment portfolios Card-shop inventory
📊 Analytics + Research Archetype meta analysis Ban-list-evolution studies Stat-distribution charts Top-card historical tracking	🎨 Content + Community Yu-Gi-Oh! blogs and YouTube Card-art galleries Tournament-prep guides Fan-fiction databases

---

🔌 Automating Yu-Gi-Oh! Card Database Scraper

Control the scraper programmatically:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval.

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows.

🎓 Research and academia TCG game-design studies Reproducible card snapshots Stat-meta evolution ML on card art	🎨 Personal and creative Personal collection trackers Custom deck builders Side projects with TCG data Fan-art catalogs
🤝 Non-profit and civic Library card-game programs Free TCG-education content Community tournaments Heritage card preservation	🧪 Experimentation Train deck-recommendation Prototype price-prediction Build archetype-discovery tools Test ban-list classifiers

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Set one or more filters (name, type, race, attribute, archetype, ban list). The Actor calls YGOProDeck and emits one record per matching card.

📊 How many fields per record?

28 base, expanding with image gallery and image IDs when alternate arts exist.

🏷️ Are race and archetype really enums?

Yes. 34 races and 638 archetypes, the schema validates input as a dropdown.

💰 How many price markets?

5: Cardmarket (EU), TCGPlayer (US), eBay, Amazon, Coolstuffinc.

📦 What about set listings?

Every printing is included as a structured object with set name, code, rarity, rarity code, and per-set price.

⚖️ How are ban lists represented?

Three string fields: banlistTcg, banlistOcg, banlistGoat. Values: Unlimited, Limited, Semi-Limited, Forbidden.

🆓 Do I need an API key?

No. YGOProDeck is free and open.

🔁 Can I schedule runs?

Yes. Schedule weekly to track price changes and ban-list updates.

⚖️ Is this data free to use?

YGOProDeck data is publicly available. Card art, names, and effects are property of Konami.

💳 Do I need a paid Apify plan?

No. The free plan covers preview runs (10 records).

---

🔌 Integrate with any app

Yu-Gi-Oh! Card Database Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications
• Airbyte - Pipe data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets to Sheets

---

🔗 Recommended Actors

• 🧠 Open Trivia DB Questions - Trivia questions across 24 categories with answers
• 🍳 Meal Recipes - Recipes with ingredients, instructions, image, video
• 🍹 Cocktail Drinks - Cocktail recipes with ingredients, glass, IBA, image
• 📚 Wikipedia Article Summary - Pull Wikipedia summaries with thumbnail, extract, geo and Wikidata link
• 🌍 REST Countries Reference Data - Every country with flag, capital, currency, languages

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Konami, Studio Dice / Shueisha, TV Tokyo, YGOProDeck, or any official Yu-Gi-Oh! organization. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.