🐉 EDHREC Magic: The Gathering Commander Scraper

🚀 Pull Commander deck statistics from EDHREC in seconds. Top commanders ranking, per-deck card categories, inclusion rates, synergy scores, salt, and live price feeds. No API key, no scraping HTML.

🕒 Last updated: 2026-05-12 · 📊 Up to 23 fields per record · 🐉 10,000+ commanders ranked · 🃏 Per-deck card breakdowns · 💰 TCGplayer + Cardmarket prices

The EDHREC MTG Commander Scraper turns EDHREC's public JSON endpoints into clean datasets across two modes. topCommanders returns the ranked list of most-played commanders for a chosen timeframe (week, month, year, 2 years, or all-time) with deck counts and inclusion rates. commanderDetail returns the average deck composition for any specific commander, broken down by card category (creatures, lands, removal, ramp, draw, etc.), each with inclusion percentages, synergy scores, and potential-deck counts.

With fetchDetails enabled, top-commander records gain color identity, converted mana cost, primary type, rarity, salt score, layout, legal status, Scryfall image URLs, and live prices from TCGplayer, Card Kingdom, and Cardmarket. EDHREC aggregates statistics from hundreds of thousands of public decks, making this the largest community deck statistics source for the Commander format.

🎯 Target Audience	💡 Primary Use Cases
EDH/Commander players, MTG content creators, deck-building tools, LGS event organizers, card-price arbitrage analysts, brewing communities, Magic data scientists	Meta tracking, deck-building AI, price-trend analysis, salt-score audits, content research, format health monitoring, brewing tool data feeds

---

📋 What the EDHREC MTG Commander Scraper does

Two scraping modes plus optional detail enrichment:

• 🏆 Top commanders ranking. Pull the ranked list of most-played commanders for the chosen timeframe.
• ⏳ 6 timeframe slices. Past week, past month, past year, past 2 years, alternative 2-year slug, or all-time.
• 🃏 Per-commander deck composition. Drill into one commander to see average card picks by category with inclusion and synergy.
• 💰 Optional price + image enrichment. Toggle fetchDetails to add color identity, salt, rarity, mana cost, layout, and live prices from three vendors.

Top-commander records include rank, name, slug, EDHREC URL, Scryfall card ID, deck count, inclusion count, and timeframe. With fetchDetails, you also get color identity, CMC, primary type, rarity, salt score, layout, legal-commander flag, normal and art-crop image URLs, Scryfall URI, and USD prices from TCGplayer, Card Kingdom, and Cardmarket. Per-commander detail records include card category, card name, slug, ID, inclusion rate, deck count, synergy score, and potential decks.

💡 Why it matters: EDHREC is the single largest source of Commander meta statistics. Manual data extraction means parsing fragile HTML on rotating pages. This Actor hits the canonical JSON endpoints directly and returns structured ranking, composition, salt, and pricing data ready for analytics, deck-builders, or content research.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded Commander stats dataset.

---

⚙️ Input

Input	Type	Default	Behavior
mode	string	"topCommanders"	Either topCommanders for the ranking, or commanderDetail for a single commander's card breakdown.
timeframe	string	"year"	For topCommanders only. One of week, month, year, 2years, past2years, alltime.
commanderSlug	string	"the-ur-dragon"	For commanderDetail only. EDHREC URL slug (e.g. atraxa-praetors-voice).
fetchDetails	boolean	false	For topCommanders only. Adds color identity, mana cost, rarity, salt, prices, and image URLs. One extra API call per commander.
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.

Example: top 100 commanders of the past year with prices.

{
    "mode": "topCommanders",
    "timeframe": "year",
    "fetchDetails": true,
    "maxItems": 100
}

Example: full Atraxa deck composition by category.

{
    "mode": "commanderDetail",
    "commanderSlug": "atraxa-praetors-voice",
    "maxItems": 1000
}

⚠️ Good to Know: EDHREC aggregates from public decklists only, so ultra-fringe brews may not appear. Slugs are case-sensitive lowercase with hyphens. Find them in the EDHREC URL after /commanders/.

---

📊 Output

Each record contains up to 23 fields depending on mode. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

topCommanders mode:

Field	Type	Example
🏷️ mode	string	"topCommanders"
🏆 rank	number	1
📌 name	string	"The Ur-Dragon"
🔗 slug	string	"the-ur-dragon"
🔗 url	string	"https://edhrec.com/commanders/the-ur-dragon"
🆔 id	string	"10d42b35-844f-4a64-9981-c6118d45e826"
🃏 numDecks	number	46794
📊 inclusion	number	46794
⏳ timeframe	string	"year"
🎨 colorIdentity	string[] | undefined	["W","U","B","R","G"]
🔢 cmc	number | undefined	7
🃏 primaryType	string | undefined	"Creature"
💎 rarity	string | undefined	"mythic"
🧂 salt	number | undefined	1.83
📐 layout	string | undefined	"normal"
✅ legalCommander	boolean | undefined	true
🖼️ imageUrl	string | undefined	"https://cards.scryfall.io/normal/..."
🖼️ artCropUrl	string | undefined	"https://cards.scryfall.io/art_crop/..."
🔗 scryfallUri	string | undefined	"https://scryfall.com/card/..."
💰 priceUsdTcgplayer	number | undefined	12.49
💰 priceUsdCardkingdom	number | undefined	14.99
💰 priceUsdCardmarket	number | undefined	9.85
🕒 scrapedAt	ISO 8601	"2026-05-12T16:30:11.540Z"

commanderDetail mode:

Field	Type	Example
🏷️ mode	string	"commanderDetail"
🔗 commanderSlug	string	"atraxa-praetors-voice"
📌 commanderName	string	"Atraxa, Praetors' Voice"
🏷️ category	string	"creatures"
🃏 cardName	string	"Doubling Season"
🔗 cardSlug	string	"doubling-season"
🆔 cardId	string	"e30a1733-95e1-4e75-..."
🔗 cardUrl	string	"https://edhrec.com/cards/doubling-season"
📊 inclusion	number | null	89
🃏 numDecks	number | null	5832
🤝 synergyScore	number | null	0.21
🃏 potentialDecks	number | null	6500
🕒 scrapedAt	ISO 8601	"2026-05-12T16:30:11.540Z"

📦 Sample records

---

✨ Why choose this Actor

	Capability
🏆	Live meta ranking. Top commanders ordered by deck count across 6 timeframe slices.
🃏	Per-deck composition. Drill into one commander for category-by-category card picks with inclusion and synergy.
🧂	Salt score. EDHREC's community salt rating tells you which commanders provoke groans at the table.
💰	Three-vendor pricing. TCGplayer, Card Kingdom, and Cardmarket USD prices in one row.
🎨	Color identity ready. Brewing tools can immediately filter by WUBRG combos.
🖼️	Scryfall art URLs. Normal and art-crop images for thumbnails and card galleries.
🔓	No login or API key. Hits public JSON endpoints only.

📊 EDHREC aggregates from hundreds of thousands of public Commander decklists for the most comprehensive format snapshot.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ EDHREC MTG Commander Scraper (this Actor)	$5 free credit, then pay-per-use	10,000+ commanders	Live per run	timeframe, slug, fetchDetails	⚡ 2 min
Manual HTML scraping of EDHREC pages	Free	Subset	Manual	None	🐢 Days
Paid card-price APIs	$25+/month	Prices only	Daily	Price-related	⏳ Hours
Community spreadsheet snapshots	Free	One-off	Rarely	None	🕒 Variable

Pick this Actor when you need the full EDHREC stats dataset with prices and Scryfall images in clean JSON.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the EDHREC MTG Commander Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode, choose a timeframe or commander slug, optionally toggle fetchDetails, and set maxItems.
4. 🚀 Run it. Click Start and let the Actor pull the rankings or deck composition.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

🃏 Deck-Building Tools Auto-recommend cards by inclusion rate Color-identity filtering with WUBRG flags Synergy-score weighting for AI brewers Average-deck templates as starter lists	📊 Format Analytics Meta share tracking across timeframes Salt-score audits for casual leagues Diversity metrics for format health reports Rotation impact studies after new sets
💰 Card Pricing & Arbitrage Cross-vendor price comparisons in one query Trend monitoring for staples Inclusion-driven price prediction models Investment-card watchlists	🎥 Content & Coverage Top-commander rankings for tier lists Deck-tech research with category breakdowns Tournament prep dossiers LGS event commentary support

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Empirical datasets for papers, thesis work, and coursework Longitudinal studies tracking changes across snapshots Reproducible research with cited, versioned data pulls Classroom exercises on data analysis and ethical scraping	🎨 Personal and creative Side projects, portfolio demos, and indie app launches Data visualizations, dashboards, and infographics Content research for bloggers, YouTubers, and podcasters Hobbyist collections and personal trackers
🤝 Non-profit and civic Transparency reporting and accountability projects Advocacy campaigns backed by public-interest data Community-run databases for local issues Investigative journalism on public records	🧪 Experimentation Prototype AI and machine-learning pipelines with real data Validate product-market hypotheses before engineering spend Train small domain-specific models on niche corpora Test dashboard concepts with live input

---

🔌 Automating EDHREC MTG Commander Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Weekly or monthly refreshes keep meta dashboards and deck-building tools in sync automatically.

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode and either a timeframe (for top commanders) or a commander slug (for deck composition), click Start, and the Actor hits EDHREC's public JSON endpoints, paginates through the data, and emits clean structured records.

🧂 What is the salt score?

Salt is EDHREC's community-driven rating of how annoying or unfun a card is. It is gathered from player upvotes and downvotes and ranges roughly from 0 (rarely complained about) to 4+ (table-flip territory). Useful for setting expectations in casual playgroups.

🔁 How often is the data refreshed?

EDHREC updates its rankings and composition stats daily. Every run of this Actor pulls the latest values. Schedule the Actor weekly or daily for a fresh mirror.

🎨 What is colorIdentity?

An array of WUBRG letters describing the commander's color identity. For example, Atraxa's identity is ["W","U","B","G"]. Use this to filter commanders that match a chosen color pie.

🏆 What timeframes are available?

week, month, year, 2years, past2years (alternative slug), and alltime. Pick a recent slice for current meta or alltime for the historical leaderboard.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor on any cron interval (hourly, daily, weekly) and keep a downstream database in sync.

⚖️ Is this data legal to use?

EDHREC publishes its statistics publicly. Card names, prices, and inclusion percentages are factual aggregations and are commonly used by deck-building tools and content creators. Card images on EDHREC come from Scryfall and Wizards of the Coast and remain under their licensing terms.

💼 Can I use this data commercially?

Statistical aggregates are commercial-fair-use in most jurisdictions. Card art and proprietary scoring algorithms may be subject to additional terms. Consult counsel for your specific use case.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

EDHREC MTG Commander Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications in your channels
• Airbyte - Pipe MTG data into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh meta data into your deck-building app, or alert your team in Slack.

---

🔗 Recommended Actors

• 🃏 Scryfall MTG Card Scraper - Magic: The Gathering card data, prints, and prices
• 🃏 MTGGoldfish Scraper - Magic deck prices, tournament results, and meta
• 🎮 BoardGameGeek Scraper - Board game ratings, rankings, and reviews
• 🎲 Lichess Chess Users Scraper - Chess player profiles and rating statistics
• 🎯 Manifold Prediction Markets Scraper - Public prediction market questions and probabilities

💡 Pro Tip: browse the complete ParseForge collection for more games and hobby-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by EDHREC, Wizards of the Coast, or any card publisher. Magic: The Gathering is a trademark of Wizards of the Coast LLC. Only publicly available statistical aggregates are collected.