YGOPRODeck

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.

YGOPRODeck publishes 5 APIs on the APIs.io network, including Archetypes API, Card Sets API, Cards API, and 2 more. Tagged areas include Games, Trading Card Games, Yu Gi Oh, Card Database, and Open Data.

The YGOPRODeck catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

YGOPRODeck’s developer surface includes documentation, pricing, tooling, and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub

25.2/100 emerging ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1

5 APIs

GamesTrading Card GamesYu Gi OhCard DatabaseOpen DataCommunity APIPublic APIs

Kin Score

Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1

Composite quality — 25.2/100 · emerging

Contract Quality 5.9 / 25

Developer Ergonomics 1.7 / 20

Commercial Clarity 2.1 / 20

Operational Transparency 0.0 / 13

Governance 8.3 / 12

Discoverability 8.2 / 10

Agent readiness — 28/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/yu-gi-oh: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

JSON Schema 15

Standalone JSON Schema definitions for this provider's data models.

Scroll for all 15

JSON Structure 15

JSON Structure definitions describing this provider's data shapes.

Scroll for all 15

Examples 15

Example request and response payloads for these APIs.

Scroll for all 15

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

Supplemental API Guide

Documentation

magicDGS-gaming/ygoprodeck-openapi

ThirdPartyOpenAPI

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Vocabulary

Vocabulary

JSONLD

JSONLD

SpectralRules

SpectralRules

Build 5

SDKs, sample code, and the tooling you integrate with

Draw Yu-Gi-Oh! Card GitHub Action

Tools

YGO Bubble Tea CLI

Tools

YGOPRODeckArchive (.NET archiver)

Tools

MCP Server (alisyedn/yugioh-mcp-server)

Tools

MCP Server (ludoplex/yugioh-mcp-server - PSCT + ruling engine)

Tools

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 1

Status, limits, changes, and where to get help

20 Requests per Second per IP (1 hour ban on violation)

RateLimits

Commercial 1

Pricing, plans, and the legal terms of use

YGOPRODeck Premium (supports the free API)

Pricing

Company 1

The organization behind the API

Website

Website

Other 1

Properties that don't map to a standard resource type

PublicAPIsListing

PublicAPIsListing

Source (apis.yml)

aid: yu-gi-oh
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/yu-gi-oh.png
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:
- aid: yu-gi-oh:yu-gi-oh-archetypes-api
  name: YGOPRODeck Archetypes API
  description: Recognised Yu-Gi-Oh! archetype catalog.
  humanURL: https://ygoprodeck.com/api-guide/
  baseURL: https://db.ygoprodeck.com/api/v7
  tags:
  - Archetypes
  properties:
  - type: OpenAPI
    url: openapi/yu-gi-oh-archetypes-api-openapi.yml
  - type: Documentation
    url: https://ygoprodeck.com/api-guide/
  - type: Documentation
    url: https://ygoprodeck.com/api-guide-supplemental/
  - type: Signup
    url: https://ygoprodeck.com/account/
  - type: SDKs
    url: https://github.com/Yeet195/pygo_API
  - type: SDKs
    url: https://github.com/kaangiray26/pydeck
  - type: SDKs
    url: https://github.com/RonaldTheodoro/ygoprodeck-api-client
  - type: SDKs
    url: https://github.com/TheAnachronism/YGOPRODeck-Api-Wrapper
  - type: SDKs
    url: https://github.com/MordechaiHadad/ygopro.NET
  - type: SDKs
    url: https://github.com/whdzera/ygoprodeck
  - type: CodeExamples
    url: https://github.com/fferegrino/yu-gi-oh
  - type: CodeExamples
    url: https://github.com/usersina/YGOCards_Downloader
  - type: Webhooks
    url: https://ygoprodeck.com/api-guide/
- aid: yu-gi-oh:yu-gi-oh-card-sets-api
  name: YGOPRODeck Card Sets API
  description: Yu-Gi-Oh! card set catalog and per-print details.
  humanURL: https://ygoprodeck.com/api-guide/
  baseURL: https://db.ygoprodeck.com/api/v7
  tags:
  - Card Sets
  properties:
  - type: OpenAPI
    url: openapi/yu-gi-oh-card-sets-api-openapi.yml
  - type: Documentation
    url: https://ygoprodeck.com/api-guide/
  - type: Documentation
    url: https://ygoprodeck.com/api-guide-supplemental/
  - type: Signup
    url: https://ygoprodeck.com/account/
  - type: SDKs
    url: https://github.com/Yeet195/pygo_API
  - type: SDKs
    url: https://github.com/kaangiray26/pydeck
  - type: SDKs
    url: https://github.com/RonaldTheodoro/ygoprodeck-api-client
  - type: SDKs
    url: https://github.com/TheAnachronism/YGOPRODeck-Api-Wrapper
  - type: SDKs
    url: https://github.com/MordechaiHadad/ygopro.NET
  - type: SDKs
    url: https://github.com/whdzera/ygoprodeck
  - type: CodeExamples
    url: https://github.com/fferegrino/yu-gi-oh
  - type: CodeExamples
    url: https://github.com/usersina/YGOCards_Downloader
  - type: Webhooks
    url: https://ygoprodeck.com/api-guide/
- aid: yu-gi-oh:yu-gi-oh-cards-api
  name: YGOPRODeck Cards API
  description: Card search, filtering, and metadata retrieval.
  humanURL: https://ygoprodeck.com/api-guide/
  baseURL: https://db.ygoprodeck.com/api/v7
  tags:
  - Cards
  properties:
  - type: OpenAPI
    url: openapi/yu-gi-oh-cards-api-openapi.yml
  - type: Documentation
    url: https://ygoprodeck.com/api-guide/
  - type: Documentation
    url: https://ygoprodeck.com/api-guide-supplemental/
  - type: Signup
    url: https://ygoprodeck.com/account/
  - type: SDKs
    url: https://github.com/Yeet195/pygo_API
  - type: SDKs
    url: https://github.com/kaangiray26/pydeck
  - type: SDKs
    url: https://github.com/RonaldTheodoro/ygoprodeck-api-client
  - type: SDKs
    url: https://github.com/TheAnachronism/YGOPRODeck-Api-Wrapper
  - type: SDKs
    url: https://github.com/MordechaiHadad/ygopro.NET
  - type: SDKs
    url: https://github.com/whdzera/ygoprodeck
  - type: CodeExamples
    url: https://github.com/fferegrino/yu-gi-oh
  - type: CodeExamples
    url: https://github.com/usersina/YGOCards_Downloader
  - type: Webhooks
    url: https://ygoprodeck.com/api-guide/
- aid: yu-gi-oh:yu-gi-oh-database-api
  name: YGOPRODeck Database API
  description: Database version and freshness information.
  humanURL: https://ygoprodeck.com/api-guide/
  baseURL: https://db.ygoprodeck.com/api/v7
  tags:
  - Database
  properties:
  - type: OpenAPI
    url: openapi/yu-gi-oh-database-api-openapi.yml
  - type: Documentation
    url: https://ygoprodeck.com/api-guide/
  - type: Documentation
    url: https://ygoprodeck.com/api-guide-supplemental/
  - type: Signup
    url: https://ygoprodeck.com/account/
  - type: SDKs
    url: https://github.com/Yeet195/pygo_API
  - type: SDKs
    url: https://github.com/kaangiray26/pydeck
  - type: SDKs
    url: https://github.com/RonaldTheodoro/ygoprodeck-api-client
  - type: SDKs
    url: https://github.com/TheAnachronism/YGOPRODeck-Api-Wrapper
  - type: SDKs
    url: https://github.com/MordechaiHadad/ygopro.NET
  - type: SDKs
    url: https://github.com/whdzera/ygoprodeck
  - type: CodeExamples
    url: https://github.com/fferegrino/yu-gi-oh
  - type: CodeExamples
    url: https://github.com/usersina/YGOCards_Downloader
  - type: Webhooks
    url: https://ygoprodeck.com/api-guide/
- aid: yu-gi-oh:yu-gi-oh-reference-data-api
  name: YGOPRODeck Reference Data API
  description: Valid value enumerations used by the search engine.
  humanURL: https://ygoprodeck.com/api-guide/
  baseURL: https://db.ygoprodeck.com/api/v7
  tags:
  - Reference Data
  properties:
  - type: OpenAPI
    url: openapi/yu-gi-oh-reference-data-api-openapi.yml
  - type: Documentation
    url: https://ygoprodeck.com/api-guide/
  - type: Documentation
    url: https://ygoprodeck.com/api-guide-supplemental/
  - type: Signup
    url: https://ygoprodeck.com/account/
  - type: SDKs
    url: https://github.com/Yeet195/pygo_API
  - type: SDKs
    url: https://github.com/kaangiray26/pydeck
  - type: SDKs
    url: https://github.com/RonaldTheodoro/ygoprodeck-api-client
  - type: SDKs
    url: https://github.com/TheAnachronism/YGOPRODeck-Api-Wrapper
  - type: SDKs
    url: https://github.com/MordechaiHadad/ygopro.NET
  - type: SDKs
    url: https://github.com/whdzera/ygoprodeck
  - type: CodeExamples
    url: https://github.com/fferegrino/yu-gi-oh
  - type: CodeExamples
    url: https://github.com/usersina/YGOCards_Downloader
  - type: Webhooks
    url: https://ygoprodeck.com/api-guide/
common:
- type: AgenticAccess
  url: agentic-access/yu-gi-oh-agentic-access.yml
- type: DomainSecurity
  url: security/yu-gi-oh-domain-security.yml
- 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

YGOPRODeck

APIs 5

Open Collections 1

Semantic Vocabularies 1

Spectral Rules 2

JSON Schema 15

JSON Structure 15

Examples 15

Security Posture 1

Agentic Access 1

Documentation 3

Agent Surfaces 1

Design & Contract 3

Build 5

Access & Security 1

Operate 1

Commercial 1

Company 1

Other 1

Source (apis.yml)