aid: yu-gi-oh
name: YGOPRODeck
description: >-
  YGOPRODeck is a community-run Yu-Gi-Oh! TCG database and deck-sharing platform that exposes
  a free, public REST API (v7) for querying every Yu-Gi-Oh! card, archetype, card set, banlist
  status, format legality, market price, and card image. The API is the canonical open data
  source used by community deck builders, mobile apps, Discord bots, simulators, and analytics
  tools across the Yu-Gi-Oh! ecosystem.
url: https://ygoprodeck.com/api-guide/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-30'
x-type: opensource
x-source: public-apis/public-apis
x-category: "Games & Comics"
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
  - Games
  - Trading Card Games
  - Yu Gi Oh
  - Card Database
  - Open Data
  - Community API
  - Public APIs
apis:
  - name: YGOPRODeck Card Database API
    description: >-
      The v7 REST API for the YGOPRODeck Yu-Gi-Oh! card database. Provides card search and
      filtering across every printed Yu-Gi-Oh! card, full card metadata (type, race, attribute,
      level, link, link markers, ATK/DEF, archetype, banlist, format legality), card sets and
      release info, archetypes, valid value enumerations, database version, and a random card
      endpoint. Free, no API key required, 20 requests per second per IP.
    humanURL: https://ygoprodeck.com/api-guide/
    baseURL: https://db.ygoprodeck.com/api/v7
    image: https://images.ygoprodeck.com/images/cards/89631146.jpg
    tags:
      - Games
      - Trading Card Games
      - Yu Gi Oh
      - Card Database
      - Card Search
      - Archetypes
      - Card Sets
      - Pricing
    properties:
      - type: Documentation
        url: https://ygoprodeck.com/api-guide/
      - type: Documentation
        title: Supplemental API Guide
        url: https://ygoprodeck.com/api-guide-supplemental/
      - type: OpenAPI
        url: openapi/yu-gi-oh-ygoprodeck-openapi.yml
      - type: NaftikoCapability
        url: capabilities/ygoprodeck-cards.yaml
      - type: NaftikoCapability
        url: capabilities/ygoprodeck-card-sets.yaml
      - type: NaftikoCapability
        url: capabilities/ygoprodeck-archetypes.yaml
      - type: NaftikoCapability
        url: capabilities/ygoprodeck-reference-data.yaml
      - type: NaftikoCapability
        url: capabilities/ygoprodeck-database.yaml
      - type: SignUp
        url: https://ygoprodeck.com/account/
      - type: SDK
        title: Python SDK (pygo_API)
        url: https://github.com/Yeet195/pygo_API
      - type: SDK
        title: Python SDK (pydeck)
        url: https://github.com/kaangiray26/pydeck
      - type: SDK
        title: Python Client (ygoprodeck-api-client)
        url: https://github.com/RonaldTheodoro/ygoprodeck-api-client
      - type: SDK
        title: ".NET / C# SDK (YGOPRODeck-Api-Wrapper)"
        url: https://github.com/TheAnachronism/YGOPRODeck-Api-Wrapper
      - type: SDK
        title: .NET Wrapper (ygopro.NET)
        url: https://github.com/MordechaiHadad/ygopro.NET
      - type: SDK
        title: JavaScript / TypeScript Wrapper
        url: https://github.com/whdzera/ygoprodeck
      - type: CodeExamples
        title: Card Dataset (Weekly Snapshot)
        url: https://github.com/fferegrino/yu-gi-oh
      - type: CodeExamples
        title: Image Downloader (Python)
        url: https://github.com/usersina/YGOCards_Downloader
      - type: Webhook
        title: Image Hotlinking Policy (do not hotlink)
        url: https://ygoprodeck.com/api-guide/
common:
  - type: Website
    url: https://ygoprodeck.com/
  - type: Documentation
    url: https://ygoprodeck.com/api-guide/
  - type: Documentation
    title: Supplemental API Guide
    url: https://ygoprodeck.com/api-guide-supplemental/
  - type: Pricing
    title: YGOPRODeck Premium (supports the free API)
    url: https://ygoprodeck.com/premium/
  - type: PublicAPIsListing
    url: https://github.com/public-apis/public-apis
  - type: ThirdPartyOpenAPI
    title: magicDGS-gaming/ygoprodeck-openapi
    url: https://github.com/magicDGS-gaming/ygoprodeck-openapi
  - type: RateLimits
    title: 20 Requests per Second per IP (1 hour ban on violation)
    url: https://ygoprodeck.com/api-guide/
  - type: Tools
    title: Draw Yu-Gi-Oh! Card GitHub Action
    url: https://github.com/Doarakko/draw-action
  - type: Tools
    title: YGO Bubble Tea CLI
    url: https://github.com/Morphclue/ygo-bubble-tea
  - type: Tools
    title: YGOPRODeckArchive (.NET archiver)
    url: https://github.com/BillyCool/YGOPRODeckArchive
  - type: Tools
    title: MCP Server (alisyedn/yugioh-mcp-server)
    url: https://github.com/alisyedn/yugioh-mcp-server
  - type: Tools
    title: MCP Server (ludoplex/yugioh-mcp-server - PSCT + ruling engine)
    url: https://github.com/ludoplex/yugioh-mcp-server
  - type: Vocabulary
    url: vocabulary/yu-gi-oh-vocabulary.yml
  - type: JSONLD
    url: json-ld/yu-gi-oh-ygoprodeck-context.jsonld
  - type: SpectralRules
    url: rules/yu-gi-oh-rules.yml
features:
  - name: Card Search
    description: >-
      Query the full Yu-Gi-Oh! card database with rich filters — exact name, fuzzy name, passcode
      ID, type, race, attribute, level/rank, link rating, link markers, ATK/DEF (with lt/lte/gt/gte
      comparison operators), pendulum scale, archetype, card set, format legality, banlist status,
      and effect-presence flag.
  - name: Multilingual Card Data
    description: >-
      Retrieve card text in English (default), French, German, Italian, and Portuguese using the
      `language` parameter on the cardinfo endpoint.
  - name: Format and Banlist Filtering
    description: >-
      Filter the catalog by tournament format (TCG, OCG, Goat, OCG Goat, Speed Duel, Master Duel,
      Rush Duel, Duel Links, GenesYS) and banlist status to power deck builders, legality checkers,
      and tournament tools.
  - name: Card Set and Print Run Catalog
    description: >-
      Enumerate every Yu-Gi-Oh! card set (1,000+) with TCG release dates, card counts, set images,
      and per-print pricing and rarity data via cardsets.php and cardsetsinfo.php.
  - name: Archetype Catalog
    description: >-
      List every recognised Yu-Gi-Oh! archetype (600+) to power archetype-based filtering, deck
      categorisation, and search-as-you-type experiences.
  - name: Market Price Aggregation
    description: >-
      Each card response includes prices from Cardmarket, TCGplayer, eBay, Amazon, and CoolStuffInc
      to power price tracking and arbitrage tools.
  - name: Card Image CDN
    description: >-
      Full-resolution, small, and cropped card images are served from images.ygoprodeck.com. Direct
      hotlinking is prohibited; consumers must download and self-host images.
  - name: Database Version Tracking
    description: >-
      The checkDBVer.php endpoint exposes the current database version and last update timestamp
      so that cached clients can invalidate efficiently.
  - name: Random Card Endpoint
    description: >-
      The randomcard.php endpoint returns a single random card and is uncached, suitable for
      "card of the day" widgets, Discord bots, and discovery features.
  - name: Open and Free Access
    description: >-
      No API key, no authentication, no quota beyond the documented 20 requests per second per IP.
      Funded by YGOPRODeck Premium subscriptions, ads, and donations rather than API metering.
useCases:
  - name: Deck Builder
    description: >-
      Web and mobile deck builders use cardinfo.php with archetype, format, and banlist filters
      to surface only the cards a player can legally include in a given tournament format.
  - name: Yu-Gi-Oh! Discord Bots
    description: >-
      Discord bots like the official YGOPRODeck bot use cardinfo.php and randomcard.php to look up
      cards, post random cards, and resolve archetype questions inside chat servers.
  - name: Price Tracker
    description: >-
      Apps that surface card prices use the per-card prices array to monitor Cardmarket/TCGplayer
      values, build watchlists, and detect arbitrage opportunities across marketplaces.
  - name: Tournament Legality Checker
    description: >-
      Tournament platforms (Master Duel, Duel Links, TCG, OCG) use the banlist and format filters
      to confirm deck legality before accepting a registration.
  - name: Card Image Pipeline
    description: >-
      Game simulators and printing tools download the full card image library once and rebuild
      their local card art catalog on each database version bump.
  - name: Card Recognition Training Data
    description: >-
      Computer vision pipelines for physical card recognition pull the entire image set as labelled
      training data, keyed by card id.
  - name: Meta and Format Analytics
    description: >-
      Meta analytics sites pull archetype and format data to build win-rate dashboards, archetype
      popularity charts, and ban-list impact studies.
integrations:
  - name: Cardmarket
    description: Per-card pricing in cardinfo responses sources Cardmarket marketplace prices.
  - name: TCGplayer
    description: Per-card pricing in cardinfo responses sources TCGplayer marketplace prices.
  - name: eBay
    description: Per-card pricing in cardinfo responses sources eBay listings.
  - name: Amazon
    description: Per-card pricing in cardinfo responses sources Amazon listings.
  - name: CoolStuffInc
    description: Per-card pricing in cardinfo responses sources CoolStuffInc marketplace prices.
  - name: Konami / 4K Media
    description: >-
      All card text and imagery is copyright Konami Digital Entertainment / 4K Media; YGOPRODeck
      surfaces and redistributes it under fair-use community-database conventions.
solutions:
  - name: Community Yu-Gi-Oh! Database
    description: >-
      A fully open, community-maintained replacement for proprietary Yu-Gi-Oh! card databases that
      lets developers build any tool — deck builder, simulator, scanner, bot — on top of the
      complete TCG corpus without contractual gates.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com