ParseForge
Yu-Gi-Oh! Card Database Scraper
parseforge/yugioh-card-database-scraper
GAMESOtherEducation
Scrapes Yu-Gi-Oh! card records from the official database. Returns name, type, race, attribute, archetype, and ban list status for each card. Filter by any combination.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 126
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
Yu-Gi-Oh! Card Database Scraper
Scrape Yu-Gi-Oh! card data from the official database, up to a million cards per run. Every card comes with its name, type, race, attribute, archetype, and ban list status. No login or API key. Export to CSV, JSON, Excel, or XML.
The official Yu-Gi-Oh! card database has no public API, and manual lookups are slow when you need hundreds of cards. This Actor reads the public card database directly and returns each matching card as a flat row, filtered by name, type, race, attribute, archetype, or ban list. It is built for collectors, deck builders, and market analysts who need clean card data without scraping it themselves.
| Who uses it | What they scrape Yu-Gi-Oh! Card Database for |
|---|---|
| Deck builders | Pull every card in an archetype to plan a new deck |
| Market analysts | Track which cards are on the TCG or OCG ban list |
| Collectors | Build a personal inventory of cards by set or rarity |
| Game developers | Seed a card database for a fan app or simulator |
| Content creators | Gather card stats for videos, articles, or tier lists |
What it does
This Actor collects Yu-Gi-Oh! card records from the official database and returns each one as a flat row with its name, type, race, attribute, archetype, and ban list status.
- 🔍 Name filter: match full or partial card names, like Dark Magician or Blue-Eyes.
- 🃏 Type filter: narrow to Effect Monster, Fusion, Synchro, XYZ, Spell, Trap, and more.
- 🐉 Race filter: pick a monster race like Dragon or Spellcaster, or a Spell/Trap kind like Continuous or Counter.
- ✨ Attribute filter: choose DARK, LIGHT, EARTH, WATER, FIRE, WIND, or DIVINE.
- 🏛️ Archetype filter: select from hundreds of archetypes, from Blue-Eyes to Zoodiac.
- 🚫 Ban list filter: restrict results to TCG, OCG, or Goat Format lists.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Yu-Gi-Oh! Card Database data
📈 Track ban list changes.
A competitive player runs the Actor with the ban list filter set to TCG every week and exports the list to see which cards moved on or off the list.
🧩 Build an archetype deck.
A deck builder filters by archetype, like Dark Magician or Blue-Eyes, and gets every legal card in that theme to plan a tournament list.
💰 Feed a pricing pipeline.
A market analyst scrapes all card names and archetypes, then joins the output with price data from TCGplayer or Cardmarket to spot undervalued cards.
🎮 Seed a fan app.
A developer pulls the full card database once, stores it locally, and uses it to power a deck builder or simulator without hitting the official site repeatedly.
📚 Research card history.
A content creator filters by race and attribute to gather all Dragon-type LIGHT monsters for a video on the game's design evolution.
Why choose this scraper
| What you get | |
|---|---|
| Official data | Reads the public Yu-Gi-Oh! card database, the same source as the official site |
| One flat row per card | Every result has the same schema, ready for CSV, JSON, Excel, or XML |
| No API key | No registration, no OAuth, no rate limits to manage |
| Up to a million cards | Paid users can pull the entire database in one run |
| Ban list aware | Filter to TCG, OCG, or Goat Format in a single select |
How it compares
This Actor focuses on official card metadata, while the competitors below focus on pricing data from marketplaces.
| Feature | ParseForge | TCGPlayer Pricing Scraper - tcgcsv.com API Wrapper | Cardmarket Yu-Gi-Oh! Trend Scraper | TCGplayer Scraper |
|---|---|---|---|---|
| Official card database metadata | Yes | Not listed | Not listed | Not listed |
| Filter by archetype | Yes | Not listed | Not listed | Not listed |
| Filter by ban list (TCG/OCG/Goat) | Yes | Not listed | Not listed | Not listed |
| Card prices | Not listed | Yes | Yes | Yes |
| Seller listings | Not listed | Not listed | Not listed | Yes |
| Marketplace trend data | Not listed | Not listed | Yes | Not listed |
Configure the run
Drive the Actor from card name, type, race, attribute, archetype, and ban list, alone or together, and filters run as each card is read so only matches reach your dataset. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10,
"name": "Dark Magician"
}
A larger pull:
{
"maxItems": 200,
"name": "Dark Magician"
}
Pricing
Pay-per-result: $0.016 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $1.60 |
| 1,000 results | $16.00 |
| 10,000 results | $160.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Yu-Gi-Oh! Card Database Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Yu-Gi-Oh! Card Database through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/yugioh-card-database-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check your filters. If you combine a name with a type or archetype that does not exist together, the result set will be empty. Try clearing filters one at a time to see which one is too restrictive.
Why did I only get 10 cards?
Free users are limited to 10 items per run as a preview. Upgrade to a paid plan and set maxItems higher to get more cards.
The run failed with a timeout. What should I do?
Large runs can take time. Reduce maxItems or narrow your filters, then retry. If the problem persists, check the Apify status page for platform issues.
Some cards are missing from the results.
The database is updated regularly, but the Actor may have cached an older version. Run the Actor again to get the latest data. If a specific card is still missing, verify its name and filters.
Can I get card images?
This Actor returns text metadata only. Card images are not included in the output. You can use the card name to fetch images from another source.
FAQ
| Question | Answer |
|---|---|
| Where does the data come from? | The Actor reads the public Yu-Gi-Oh! card database, the same source used by the official Konami card search. It does not use an unofficial API or a third-party mirror. |
| Can I scrape the entire Yu-Gi-Oh! card database? | Yes. Paid users can set maxItems up to 1,000,000, which covers the full database. Free users are limited to 10 items as a preview. |
| What filters can I combine? | You can combine name, type, race, attribute, archetype, and ban list. All filters are optional and applied together, so you can narrow to exactly the cards you need. |
| Does this Actor return card prices? | No. This Actor returns card metadata from the official database: name, type, race, attribute, archetype, and ban list status. For prices, use a dedicated pricing scraper like TCGplayer or Cardmarket. |
| What is the difference between TCG and OCG ban lists? | TCG is the Western ban list, OCG is the Asian ban list, and Goat Format is a retro 2005-era list. The Actor lets you filter to any of the three. |
| Can I filter by card set or rarity? | Not in this version. The Actor filters by name, type, race, attribute, archetype, and ban list. Set and rarity are not available as filters. |
| What output formats are supported? | The Actor returns data in CSV, JSON, Excel, and XML. You choose the format when you run it or when you export from the dataset. |
| Is there a rate limit? | The Actor manages request pacing automatically. Free users are limited to 10 items per run; paid users can request up to 1,000,000 items. |
| Can I schedule this Actor to run daily? | Yes. You can set up a schedule in Apify to run the Actor daily, weekly, or at any interval, and it will update your dataset with the latest card data. |
| Does this Actor work with the Japanese card database? | The Actor reads the English-language official database. Japanese card names are not included in the output. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Konami Digital Entertainment. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| maxItems | integer | Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 | 10 |
| name | string | Match card name (full or partial). Empty = any. | Dark Magician |
| type | string (30 options) | Specific card type filter. | not set |
| race | string (34 options) | Monster race (Dragon, Spellcaster, Warrior, etc.) or Spell/Trap kind (Continuous, Quick-Play, Counter, etc.). Empty = any. | not set |
| attribute | string (8 options) | Monster attribute. | not set |
| archetype | string (638 options) | Card archetype (e.g. Blue-Eyes, Dark Magician, Six Samurai). Empty = any. | not set |
| banlist | string (4 options) | Filter to cards in a specific ban list. | not set |
Pricing
from $12.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| Result item | Charged per record successfully returned in the dataset. | $0.012 to $0.016 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~yugioh-card-database-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.