Yu-Gi-Oh Card Database & Prices — YGOProDeck API Wrapper

Pull structured Yu-Gi-Oh card data from YGOProDeck, the community card database behind most Yu-Gi-Oh deck builders and format trackers. Returns card stats, full rules text, every printing, TCG/OCG/Goat banlist status, and live marketplace prices for any card in the roughly 14,600-card catalog.

---

YGOProDeck Card Database Features

• Searches by card type, race, attribute, or level — in any combination
• Fetches specific cards by exact name, or walks an entire archetype, set, or banlist
• Pulls the full card corpus in one run when you need the whole catalog, not a slice
• Returns rules text, Pendulum scale, Link rating and arrows, and format legality in the same record
• Includes live prices from Cardmarket, TCGPlayer, eBay, Amazon, and CoolStuffInc per card — no separate price lookup needed
• Lists every printing of a card, with set name, rarity, and set-specific price

---

Who Uses Yu-Gi-Oh Card Data?

• Deck-builder app developers — back a card search or autocomplete feature without maintaining your own catalog
• Format and banlist trackers — pull current TCG, OCG, and Goat ban status in one pass instead of three separate lookups
• Price-tracking tools — compare Cardmarket, TCGPlayer, eBay, Amazon, and CoolStuffInc prices for a card or a whole archetype
• Collectors and sellers — check every printing and rarity of a card before listing or buying
• Master Duel and EDOPro community tools — ship rules text and card stats alongside your own content, instead of hand-copying them

---

How the YGOProDeck Wrapper Works

1. Pick a mode — filter search, exact name, archetype, set, banlist, or a full corpus dump.
2. Add the filters that mode supports (card type, race, attribute, level for search; one or more names, archetypes, sets, or banlist formats for the rest).
3. The actor queries YGOProDeck and returns one row per matching card, deduplicated across any overlapping selections.
4. Results stop at your maxItems cap, or run unbounded for a full-corpus pull.

---

Input

{
  "mode": "search",
  "cardTypes": ["Effect Monster"],
  "attributes": ["DARK"],
  "level": 7,
  "includePrices": true,
  "includeAllPrintings": true,
  "maxItems": 50
}

Field	Type	Default	Description
mode	String	search	search, by_name, by_archetype, by_set, by_banlist, or full_dump
cardTypes	Array	[]	Filter Search mode: one or more card types (union)
races	Array	[]	Filter Search mode: one or more monster races or Spell/Trap sub-types (union)
attributes	Array	[]	Filter Search mode: one or more monster attributes (union)
level	Integer	0	Filter Search mode: monster level/rank (0 = ignore)
archetypes	Array	—	By Archetype mode: one or more archetype names
cardName	Array	—	By Name mode: one or more exact card names
setNames	Array	—	By Set mode: one or more full set names
banlists	Array	["tcg"]	By Banlist mode: one or more of tcg, ocg, goat
includePrices	Boolean	true	Include Cardmarket/TCGPlayer/eBay/Amazon/CoolStuffInc prices
includeAllPrintings	Boolean	true	Include every printing (set, rarity, set price) per card
maxItems	Integer	10	Maximum cards to return. 0 = unlimited — use with Full Corpus Dump

By Name example — fetch two specific cards:

{
  "mode": "by_name",
  "cardName": ["Blue-Eyes White Dragon", "Dark Magician"],
  "maxItems": 10
}

By Banlist example — walk the current TCG Forbidden/Limited list:

{
  "mode": "by_banlist",
  "banlists": ["tcg"],
  "maxItems": 0
}

---

YGOProDeck Wrapper Output Fields

{
  "id": 89631139,
  "name": "Blue-Eyes White Dragon",
  "type": "Normal Monster",
  "humanReadableCardType": "Normal Monster",
  "frameType": "normal",
  "desc": "This legendary dragon is a powerful engine of destruction...",
  "race": "Dragon",
  "attribute": "LIGHT",
  "atk": 3000,
  "def": 2500,
  "level": 8,
  "archetype": "Blue-Eyes",
  "banlist_info": null,
  "card_prices": [
    { "cardmarket_price": "1.25", "tcgplayer_price": "2.10", "ebay_price": "4.99", "amazon_price": "6.49", "coolstuffinc_price": "1.99" }
  ],
  "card_sets": [
    { "set_name": "Legend of Blue Eyes White Dragon", "set_code": "LOB-001", "set_rarity": "Ultra Rare", "set_rarity_code": "(UR)", "set_price": "24.99" }
  ],
  "image_url": "https://images.ygoprodeck.com/images/cards/89631139.jpg",
  "ygoprodeck_url": "https://ygoprodeck.com/card/blue-eyes-white-dragon-123"
}

Field	Type	Description
id	Number	YGOProDeck card ID
name	String	Card name
typeline	Array	Full type line (e.g. ["Dragon", "Pendulum", "Effect"])
type	String	Card type (e.g. Effect Monster, Spell Card)
humanReadableCardType	String	Human-readable card type
frameType	String	Frame type — effect, xyz, synchro, link, normal, spell, trap, and others
desc	String	Card rules text
race	String	Race (monster) or sub-type (Spell/Trap)
attribute	String	Monster attribute — DARK, LIGHT, FIRE, WATER, EARTH, WIND, DIVINE
atk / def	Number	Attack / Defense
level	Number	Level or Rank
scale	Number	Pendulum scale — Pendulum monsters only
linkval	Number	Link rating — Link monsters only
linkmarkers	Array	Link arrow directions — Link monsters only
archetype	String	Archetype
banlist_info	Object	TCG / OCG / Goat ban status
card_prices	Array	Cardmarket, TCGPlayer, eBay, Amazon, and CoolStuffInc prices
card_sets	Array	Every printing — set name, set code, rarity, set price
image_url	String	Card image URL
ygoprodeck_url	String	Canonical YGOProDeck card page

---

FAQ

How do I scrape Yu-Gi-Oh card data from YGOProDeck?

Run the YGOProDeck wrapper with a mode and your filters — no account or API key required. Pick search for stat-based filtering, by_name for specific cards, or full_dump to pull the whole catalog in one run.

What data can I get from YGOProDeck?

Card stats, rules text, archetype, every printing with rarity, TCG/OCG/Goat banlist status, and live prices from five marketplaces. If a field exists in YGOProDeck's own card data, this actor returns it.

Can I filter by attribute, type, or level at the same time?

Yes. cardTypes, races, attributes, and level combine in one Filter Search query — set the ones you need and leave the rest blank.

How much does the YGOProDeck wrapper cost to run?

Pricing is per record returned, at a low per-record rate reflecting a clean, unauthenticated source — check the Pricing tab on this actor's Apify page for the current rate.

Do I need a YGOProDeck account or API key?

No. YGOProDeck's card data is open and unauthenticated, and this actor needs nothing from you beyond your filter choices.

---

Need More Features?

Need another mode, a filter this actor doesn't expose yet, or a different source entirely? File an issue or get in touch.

Why Use the YGOProDeck Wrapper?

• Floor-priced — a public, unauthenticated catalog with near-zero compute cost, priced accordingly.
• One row, five marketplaces — Cardmarket, TCGPlayer, eBay, Amazon, and CoolStuffInc prices arrive on the same record as the card's stats, so you're not stitching together four separate lookups.
• Six ways in — search by stats, fetch by name, or walk an archetype, set, or banlist. Pick whichever matches how you already think about the card pool.