YGOPRODeck · Schema

Card

A single Yu-Gi-Oh! card, including metadata, set printings, image URLs, and marketplace prices.

GamesTrading Card GamesYu Gi OhCard DatabaseOpen DataCommunity APIPublic APIs

Properties

Name	Type	Description
id	integer	8-digit Yu-Gi-Oh! card passcode (unique per card).
name	string	Card name (in the requested language).
typeline	array	Type line tokens (e.g. `["Spellcaster", "Normal"]`).
type	string	Card type (e.g. `Normal Monster`, `Effect Monster`, `Spell Card`, `Trap Card`, `Link Monster`).
humanReadableCardType	string	Human-friendly version of the card type.
frameType	string	The card frame style (e.g. `normal`, `effect`, `synchro`, `xyz`, `link`, `spell`, `trap`).
desc	string	Card effect / flavour text.
race	string	Monster race (e.g. `Spellcaster`, `Dragon`) or Spell/Trap sub-type (`Continuous`, `Quick-Play`, `Counter`).
atk	integer	Attack value (monsters only).
def	integer	Defense value (non-Link monsters only).
level	integer	Card level or rank (monsters only).
attribute	string	Monster attribute.
linkval	integer	Link rating (Link Monsters only).
linkmarkers	array	Link marker positions (Link Monsters only).
scale	integer	Pendulum scale value (Pendulum monsters only).
archetype	string	Archetype the card belongs to (e.g. `Blue-Eyes`, `Dark Magician`).
ygoprodeck_url	string	Canonical YGOPRODeck card page URL.
card_sets	array	Every set printing this card has appeared in.
card_images	array	Available image URLs for each artwork variant of this card.
card_prices	array	Marketplace prices aggregated across Cardmarket, TCGplayer, eBay, Amazon, and CoolStuffInc.
misc_info	array	Extended metadata, present only when the search was made with `misc=yes`.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/yu-gi-oh/refs/heads/main/json-schema/ygoprodeck-api-card-schema.json",
  "title": "Card",
  "description": "A single Yu-Gi-Oh! card, including metadata, set printings, image URLs, and marketplace prices.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "8-digit Yu-Gi-Oh! card passcode (unique per card).",
      "example": 46986414
    },
    "name": {
      "type": "string",
      "description": "Card name (in the requested language).",
      "example": "Dark Magician"
    },
    "typeline": {
      "type": "array",
      "description": "Type line tokens (e.g. `[\"Spellcaster\", \"Normal\"]`).",
      "items": {
        "type": "string"
      },
      "example": [
        "Spellcaster",
        "Normal"
      ]
    },
    "type": {
      "type": "string",
      "description": "Card type (e.g. `Normal Monster`, `Effect Monster`, `Spell Card`, `Trap Card`, `Link Monster`).",
      "example": "Normal Monster"
    },
    "humanReadableCardType": {
      "type": "string",
      "description": "Human-friendly version of the card type.",
      "example": "Normal Monster"
    },
    "frameType": {
      "type": "string",
      "description": "The card frame style (e.g. `normal`, `effect`, `synchro`, `xyz`, `link`, `spell`, `trap`).",
      "example": "normal"
    },
    "desc": {
      "type": "string",
      "description": "Card effect / flavour text.",
      "example": "The ultimate wizard in terms of attack and defense."
    },
    "race": {
      "type": "string",
      "description": "Monster race (e.g. `Spellcaster`, `Dragon`) or Spell/Trap sub-type (`Continuous`, `Quick-Play`, `Counter`).",
      "example": "Spellcaster"
    },
    "atk": {
      "type": "integer",
      "description": "Attack value (monsters only).",
      "example": 2500
    },
    "def": {
      "type": "integer",
      "description": "Defense value (non-Link monsters only).",
      "example": 2100
    },
    "level": {
      "type": "integer",
      "description": "Card level or rank (monsters only).",
      "example": 7
    },
    "attribute": {
      "type": "string",
      "description": "Monster attribute.",
      "enum": [
        "DARK",
        "LIGHT",
        "WATER",
        "FIRE",
        "WIND",
        "EARTH",
        "DIVINE"
      ],
      "example": "DARK"
    },
    "linkval": {
      "type": "integer",
      "description": "Link rating (Link Monsters only).",
      "example": 4
    },
    "linkmarkers": {
      "type": "array",
      "description": "Link marker positions (Link Monsters only).",
      "items": {
        "type": "string",
        "enum": [
          "Top",
          "Bottom",
          "Left",
          "Right",
          "Top-Left",
          "Top-Right",
          "Bottom-Left",
          "Bottom-Right"
        ]
      },
      "example": [
        "Top",
        "Bottom-Left",
        "Bottom-Right"
      ]
    },
    "scale": {
      "type": "integer",
      "description": "Pendulum scale value (Pendulum monsters only).",
      "example": 4
    },
    "archetype": {
      "type": "string",
      "description": "Archetype the card belongs to (e.g. `Blue-Eyes`, `Dark Magician`).",
      "example": "Dark Magician"
    },
    "ygoprodeck_url": {
      "type": "string",
      "format": "uri",
      "description": "Canonical YGOPRODeck card page URL.",
      "example": "https://ygoprodeck.com/card/dark-magician-4087"
    },
    "card_sets": {
      "type": "array",
      "description": "Every set printing this card has appeared in.",
      "items": {
        "type": "object",
        "description": "A single set printing of a card.",
        "properties": {
          "set_name": {
            "type": "string",
            "description": "Set name (e.g. `Legend of Blue Eyes White Dragon`).",
            "example": "Legend of Blue Eyes White Dragon"
          },
          "set_code": {
            "type": "string",
            "description": "Set code identifying this printing (e.g. `LOB-EN001`).",
            "example": "LOB-EN001"
          },
          "set_rarity": {
            "type": "string",
            "description": "Rarity of this printing.",
            "example": "Ultra Rare"
          },
          "set_rarity_code": {
            "type": "string",
            "description": "Short rarity code (e.g. `(UR)`).",
            "example": "(UR)"
          },
          "set_price": {
            "type": "string",
            "description": "Price of this printing (USD, stringified decimal).",
            "example": "6.97"
          }
        },
        "required": [
          "set_name",
          "set_code",
          "set_rarity"
        ]
      }
    },
    "card_images": {
      "type": "array",
      "description": "Available image URLs for each artwork variant of this card.",
      "items": {
        "type": "object",
        "description": "Image URLs for a single artwork variant of a card.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Image id (matches the card id for the default artwork; differs for alternate artworks).",
            "example": 46986414
          },
          "image_url": {
            "type": "string",
            "format": "uri",
            "description": "Full-size card image URL. Do not hotlink \u2014 download and self-host.",
            "example": "https://images.ygoprodeck.com/images/cards/46986414.jpg"
          },
          "image_url_small": {
            "type": "string",
            "format": "uri",
            "description": "Small / thumbnail image URL.",
            "example": "https://images.ygoprodeck.com/images/cards_small/46986414.jpg"
          },
          "image_url_cropped": {
            "type": "string",
            "format": "uri",
            "description": "Cropped artwork-only image URL (no frame).",
            "example": "https://images.ygoprodeck.com/images/cards_cropped/46986414.jpg"
          }
        },
        "required": [
          "id",
          "image_url",
          "image_url_small",
          "image_url_cropped"
        ]
      }
    },
    "card_prices": {
      "type": "array",
      "description": "Marketplace prices aggregated across Cardmarket, TCGplayer, eBay, Amazon, and CoolStuffInc.",
      "items": {
        "type": "object",
        "description": "Marketplace prices for a card (USD, stringified decimal).",
        "properties": {
          "cardmarket_price": {
            "type": "string",
            "description": "Cardmarket price (USD).",
            "example": "0.02"
          },
          "tcgplayer_price": {
            "type": "string",
            "description": "TCGplayer price (USD).",
            "example": "0.24"
          },
          "ebay_price": {
            "type": "string",
            "description": "eBay price (USD).",
            "example": "0.99"
          },
          "amazon_price": {
            "type": "string",
            "description": "Amazon price (USD).",
            "example": "14.45"
          },
          "coolstuffinc_price": {
            "type": "string",
            "description": "CoolStuffInc price (USD).",
            "example": "0.39"
          }
        }
      }
    },
    "misc_info": {
      "type": "array",
      "description": "Extended metadata, present only when the search was made with `misc=yes`.",
      "items": {
        "type": "object",
        "description": "Extended per-card metadata returned only when `misc=yes` is passed to `/cardinfo.php`.",
        "properties": {
          "beta_name": {
            "type": "string",
            "description": "Original beta name (if different from the released name)."
          },
          "views": {
            "type": "integer",
            "description": "YGOPRODeck card page view count.",
            "example": 152340
          },
          "viewsweek": {
            "type": "integer",
            "description": "YGOPRODeck card page view count over the last 7 days.",
            "example": 421
          },
          "upvotes": {
            "type": "integer",
            "description": "Community upvote count.",
            "example": 540
          },
          "downvotes": {
            "type": "integer",
            "description": "Community downvote count.",
            "example": 12
          },
          "formats": {
            "type": "array",
            "description": "Tournament formats the card is legal in.",
            "items": {
              "type": "string"
            },
            "example": [
              "TCG",
              "OCG",
              "Master Duel"
            ]
          },
          "treated_as": {
            "type": "string",
            "description": "An alternate card name this card is officially treated as (for ruling purposes)."
          },
          "tcg_date": {
            "type": "string",
            "format": "date",
            "description": "TCG (English) release date.",
            "example": "2002-03-08"
          },
          "ocg_date": {
            "type": "string",
            "format": "date",
            "description": "OCG (Japanese) release date.",
            "example": "1999-02-04"
          },
          "konami_id": {
            "type": "integer",
            "description": "Internal Konami card id.",
            "example": 4007
          },
          "has_effect": {
            "type": "integer",
            "description": "1 if the card has an actual rules effect; 0 if not.",
            "example": 0
          },
          "md_rarity": {
            "type": "string",
            "description": "Master Duel rarity (if applicable).",
            "example": "UR"
          },
          "genesys_points": {
            "type": "integer",
            "description": "GenesYS-format point cost. Only returned when `format=genesys` is passed.",
            "example": 100
          },
          "question_atk": {
            "type": "integer",
            "description": "1 if the card has `?` as ATK (special-case Pendulum/Effect ATK)."
          },
          "question_def": {
            "type": "integer",
            "description": "1 if the card has `?` as DEF."
          },
          "staple": {
            "type": "string",
            "description": "`yes` if YGOPRODeck classifies this card as a staple in any format."
          }
        }
      }
    }
  },
  "required": [
    "id",
    "name",
    "type",
    "frameType",
    "desc"
  ]
}