Yu-Gi-Oh! Card Database Scraper

Scrape Yu-Gi-Oh! card data, stats, and market prices from YGOPRODeck — the largest free Yu-Gi-Oh! card database with 12,000+ cards, set information, and live market prices from TCGPlayer, Cardmarket, and eBay.

Features

• Search cards by name, type, attribute (DARK/LIGHT/etc.), race, archetype, or level
• Fetch all cards from a specific set (e.g. Legend of Blue Eyes White Dragon)
• Fetch all cards in an archetype (Blue-Eyes, Dark Magician, Exodia, etc.)
• Live market prices: TCGPlayer (USD), Cardmarket (EUR), eBay, Amazon, CoolStuffInc
• Full card stats: ATK/DEF, Level/Rank, description, frame type
• Card images (full, small, cropped)
• Complete set appearance history with per-set prices
• No API key or login required

Modes

Mode	Description
search	Search cards by name and optional filters (type, attribute, race, archetype, level)
cardSet	Fetch all cards from a specific set code (e.g. LOB, SDK)
archetype	Fetch all cards belonging to an archetype
random	Fetch random cards

Input

Field	Type	Description
mode	select	Operation mode (see table above)
searchQuery	String	Card name to search (partial match) or archetype in archetype mode
cardType	select	Filter by card type (Effect Monster, Spell Card, etc.)
attribute	select	Filter monsters by attribute (DARK, LIGHT, FIRE, WATER, EARTH, WIND)
race	select	Filter monsters by race (Dragon, Warrior, Spellcaster, etc.)
archetype	String	Archetype name for archetype mode
setCode	String	Set code for cardSet mode (e.g. LOB, SDBE)
level	Integer	Filter monsters by exact level/rank (1–12)
maxItems	Integer	Max cards to return (1–500, default 50)

Output

Each record represents one Yu-Gi-Oh! card:

Field	Type	Description
cardId	Integer	YGOPRODeck card ID
name	String	Card name
type	String	Card type (Effect Monster, Spell Card, Trap Card, etc.)
frameType	String	Card frame (normal, effect, spell, trap, fusion, etc.)
description	String	Card effect or flavor text
race	String	Monster race/subtype (Dragon, Warrior, etc.)
attribute	String	Monster attribute (DARK, LIGHT, FIRE, etc.)
level	Integer	Monster level or rank
attack	Integer	Monster ATK (monsters only)
defense	Integer	Monster DEF (monsters only)
archetype	String	Card archetype (if any)
cardUrl	String	YGOPRODeck card page URL
imageUrl	String	Full card image URL
imageUrlSmall	String	Small card image URL
priceUsdTcgPlayer	Number	TCGPlayer price (USD)
priceEurCardmarket	Number	Cardmarket price (EUR)
priceUsdEbay	Number	eBay market price (USD)
priceUsdAmazon	Number	Amazon price (USD)
priceUsdCoolStuffInc	Number	CoolStuffInc price (USD)
cardSets	Array	Set appearances with code, rarity, and price
scrapedAt	String	ISO 8601 timestamp

Example Input

{
  "mode": "search",
  "searchQuery": "Blue-Eyes",
  "attribute": "LIGHT",
  "race": "Dragon",
  "maxItems": 20
}

{
  "mode": "archetype",
  "archetype": "Dark Magician",
  "maxItems": 50
}

{
  "mode": "cardSet",
  "setCode": "LOB",
  "maxItems": 100
}

Example Output

{
  "cardId": 89631139,
  "name": "Blue-Eyes White Dragon",
  "type": "Normal Monster",
  "frameType": "normal",
  "description": "This legendary dragon is a powerful engine of destruction...",
  "race": "Dragon",
  "attribute": "LIGHT",
  "level": 8,
  "attack": 3000,
  "defense": 2500,
  "cardUrl": "https://ygoprodeck.com/card/blue-eyes-white-dragon-5901",
  "imageUrl": "https://images.ygoprodeck.com/images/cards/89631139.jpg",
  "priceUsdTcgPlayer": 1.75,
  "priceEurCardmarket": 0.85,
  "priceUsdEbay": 4.50,
  "cardSets": [
    {"setName": "Legend of Blue Eyes White Dragon", "setCode": "LOB-001", "rarity": "Ultra Rare", "setPrice": 47.50}
  ],
  "scrapedAt": "2024-01-15T10:30:00Z"
}

Use Cases

• Card collectors: Research card values across different markets and rarities
• Deck builders: Find all cards in an archetype or set for deck construction
• Price arbitrage: Compare TCGPlayer vs Cardmarket vs eBay prices
• Game developers: Access card database for Yu-Gi-Oh! tools and apps
• Researchers: Analyze card design trends across 25+ years of the game

FAQ

How many cards are in the database? YGOPRODeck tracks 12,000+ unique Yu-Gi-Oh! cards including all TCG and OCG releases.

How often are prices updated? Prices are updated daily from TCGPlayer, Cardmarket, eBay, Amazon, and CoolStuffInc.

Can I search in other languages? The database is in English. Card names match the official TCG English names.

Do I need an API key? No. YGOPRODeck provides free public API access with no authentication required.