This is currently the latest API version (v2). For v1 information please see here.
Our Yu-Gi-Oh! API is now available for public consumption. Below are the details on how to use the API and what kind of response is to be expected from the API.
Please download and store all data pulled from this API locally to keep the amount of API calls used to a minimum. Failure to do so may result in either your IP address being blacklisted or the API being rolled back.
Rate Limiting on the API is enabled. The rate limit is 20 requests per 1 second. If you exceed this, you are blocked from accessing the API for 1 hour. We will monitor this rate limit for now and adjust accordingly.
Our API responses are cached on our side. The cache timings will be given below. These are subject to change.
The Card Information endpoint is available at
This is the only endpoint that is now needed. You can pass multiple paramters to this endpoint to filter the information retrieved.
The following endpoint parameters can be passed:
&fname=Magicianto search by all cards with "Magician" in the name.
The specific results from this endpoint are cached for 2 days (172800 seconds) but will be manually cleared upon new card entry.
We are working on to soon include price data as part of the response information.
The following is a list of examples you can do using the possible endpoint parameters shown above.
Get all cards
Get "Dark Magician" card information
Get all cards belonging to "Blue-Eyes" archetype
Get all Level 4/RANK 4 Water cards and order by atk
Get all cards on the TCG Banlist who are level 4 and order them by name (A-Z)
Get all Dark attribute monsters from the Metal Raiders set
Get all cards with "Wizard" in their name who have are LIGHT attribute monsters with a race of Spellcaster
Get all Spell Cards that are Equip Spell Cards
Get "Dark Magician" card information using his ID in the French language
Parameter "Race" values:
Parameter "Type" values:
Main Deck Types
Extra Deck Types
Our API only officially supports English as a response language but we are adding unofficial languages bit by bit. What do we mean by unofficial? Translations may not be accurate and card information may be out of date.
The other language APIs are essentially used to have a foundation of what you want to build. Please do not email or contact us about adding languages or to continually update other language information.
Currently Supported Languages:
Card images can be pulled from our Google Cloud server but please only pull an image once and then store it locally. If we find you are pulling a very high volume of images per second then your IP will be blacklisted and blocked.
Our card images are in
.jpg format and are web optimized.
All of our cloud URLs will either be
https://storage.googleapis.com/ygoprodeck.com/pics_small/. You pass the ID of the card to retrieve the image.
Example Limit Reverse Card Image:
The image URLs are found within the JSON response as both