# Scryfall Magic The Gathering Scraper (`parseforge/scryfall-mtg-scraper`) Actor Scrape Magic The Gathering card data including names, mana costs, types, rarity, images, pricing in USD and EUR, format legalities, and set details. Filter by text query, set code, or format. Covers 100,000+ unique cards across every MTG set. - **URL**: https://apify.com/parseforge/scryfall-mtg-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** News, Developer tools, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $6.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg) ## 🃏 Scryfall Magic: The Gathering Card Scraper If you run a card shop, build MTG price trackers, or manage a large collection, this tool pulls structured Magic: The Gathering card data fast. Search by color, type, format, mana cost, set, or any Scryfall search syntax and get back clean records with images, prices, legalities, and oracle text. > **The Scryfall MTG Scraper collects Magic: The Gathering cards with names, mana costs, types, rarities, set info, pricing in USD/EUR/Tix, format legalities, oracle text, and card images.** ### ✨ What Does It Do - 🃏 **Card details** - names, mana costs, type lines, power/toughness, loyalty, and oracle text - 💰 **Live prices** - USD, USD foil, EUR, and MTGO Tix values for every printing - 🎨 **Card images** - high quality card art URLs ready to embed or download - 📜 **Format legalities** - Standard, Pioneer, Modern, Legacy, Vintage, Commander, Pauper, Brawl - 🔍 **Advanced search** - use Scryfall's full search syntax for precise targeting - 📊 **Set info** - collector numbers, release dates, artists, and set codes - 🏆 **EDHREC ranking** - see how popular a card is in Commander decks ### 🔧 Input - **Search Query** - any Scryfall query string (e.g. `t:creature c:red`, `name:phoenix`, `pow>=5`) - **Set Code** - filter by a specific set (e.g. `mh3`, `neo`, `bro`) - **Format** - only cards legal in Standard, Modern, Commander, etc. - **Sort Order** - release date, name, mana cost, price, EDHREC rank, and more - **Max Items** - free users get 10 cards, paid users up to 1,000,000 ```json { "query": "t:creature c:red", "format": "commander", "order": "edhrec", "maxItems": 100 } ```` ### 📊 Output Each card record contains 35+ fields. Download as JSON, CSV, or Excel. | 📌 Field | 📄 Description | |----------|---------------| | 🖼️ imageUrl | Normal card art URL | | 📝 name | Card name | | 🔮 manaCost | Mana cost symbols | | 🧙 typeLine | Full type line (e.g. "Creature - Dragon") | | 📜 oracleText | Card rules text | | ⚔️ power | Power value (creatures) | | 🛡️ toughness | Toughness value (creatures) | | 💎 rarity | common, uncommon, rare, mythic | | 📦 set | Set code | | 💵 priceUsd | Current USD price | | 💶 priceEur | Current EUR price | | ✅ legalStandard | Legal status in Standard | | 👑 legalCommander | Legal status in Commander | | 🎨 artist | Card illustrator | | 📈 edhrecRank | EDHREC popularity rank | ```json { "imageUrl": "https://cards.scryfall.io/normal/front/...", "name": "Lightning Bolt", "manaCost": "{R}", "cmc": 1, "typeLine": "Instant", "oracleText": "Lightning Bolt deals 3 damage to any target.", "colors": ["R"], "rarity": "common", "set": "m11", "setName": "Magic 2011", "priceUsd": 1.49, "priceEur": 0.92, "legalModern": "legal", "legalCommander": "legal", "artist": "Christopher Moeller", "edhrecRank": 45, "scrapedAt": "2026-04-10T12:00:00.000Z" } ``` ### 💎 Why Choose the Scryfall MTG Scraper? | Feature | Our Tool | Manual Browsing | |---------|----------|----------------| | Bulk card extraction | ✅ Up to 1M cards | ❌ One at a time | | Full Scryfall search syntax | ✅ Yes | ⚠️ Limited web UI | | Format legalities | ✅ All formats | ⚠️ Must click each card | | Prices in USD/EUR/Tix | ✅ Included | ⚠️ Scattered | | Structured export | ✅ JSON, CSV, Excel | ❌ HTML pages | | Scheduled price tracking | ✅ Daily runs | ❌ Not possible | ### 📋 How to Use 1. **Sign Up** - [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. **Configure** - enter your Scryfall search query and filters 3. **Run It** - click Start and get card data in seconds No coding, no browser tabs, no manual card-by-card clicks. ### 🎯 Business Use Cases - 🛒 **Card shops** - track retail prices across the entire catalog and reprice inventory - 💹 **Price trackers** - build daily snapshots of card values for investor dashboards - 🎮 **Deck builders** - pull every legal card for a format to power deckbuilder apps - 📚 **Collection managers** - import card metadata into your collection tracker - 🤖 **MTG bots** - feed Discord bots with card lookups, prices, and images - 📈 **Market research** - analyze price movements across sets, rarities, and formats ### ❓ FAQ 🔮 **What is Scryfall?** Scryfall is the largest Magic: The Gathering card database, covering every card ever printed with high resolution images, prices, and rulings. 🔍 **Can I use Scryfall's advanced search syntax?** Yes. The query field accepts the full Scryfall syntax, including things like `t:creature c:red cmc<=3`, `name:phoenix`, `legal:commander`, `set:mh3`, and more. 💰 **How current are the prices?** Prices update daily from TCGplayer, Cardmarket, and MTGO Cardhoarder, so each run pulls the latest values. 📦 **Can I filter to just one set?** Yes. Use the Set Code field (e.g. `mh3` for Modern Horizons 3) or include `set:mh3` in the query. 🎨 **Are card images included?** Yes. Every card comes with an image URL in the `imageUrl` field. ### 🔗 Integrate Scryfall MTG Scraper with any app - [Make](https://docs.apify.com/platform/integrations/make) - automate card data syncs - [Zapier](https://docs.apify.com/platform/integrations/zapier) - trigger price alerts - [Slack](https://docs.apify.com/platform/integrations/slack) - post new card releases to a channel - [Google Sheets](https://docs.apify.com/platform/integrations/drive) - maintain a card inventory spreadsheet - [Webhooks](https://docs.apify.com/platform/integrations/webhooks) - trigger workflows on completion ### 💡 Recommended Actors Looking for more data collection tools? Check out these related actors: | Actor | Description | Link | |-------|-------------|------| | Hugging Face Model Scraper | Collect AI model metadata | [Link](https://apify.com/parseforge/hugging-face-model-scraper) | | Apple App Store Scraper | Grab app listings and ratings | [Link](https://apify.com/parseforge/apple-app-store-iphone-scraper) | | Bring A Trailer Auctions Scraper | Car auction listings and bids | [Link](https://apify.com/parseforge/bringatrailer-auctions-scraper) | | duPont Registry Scraper | Luxury car marketplace listings | [Link](https://apify.com/parseforge/dupont-registry-scraper) | | Flippa Scraper | Online business for sale listings | [Link](https://apify.com/parseforge/flippa-scraper) | **Pro Tip:** 💡 Browse the full [ParseForge catalog](https://apify.com/parseforge) to find more data tools. ### 🆘 Need Help? - Check the FAQ section above for common questions - Visit the [Apify documentation](https://docs.apify.com) for platform guides - Contact us at [Tally contact form](https://tally.so/r/BzdKgA) ### ⚠️ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or connected to Scryfall, Wizards of the Coast, or Magic: The Gathering. It collects only publicly available card data. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 cards. Paid users: Optional, max 1,000,000 ## `query` (type: `string`): Scryfall search syntax. Examples: 'lightning bolt', 't:creature c:red', 'pow>=5', 'name:phoenix' ## `set` (type: `string`): Filter by set code (e.g. 'mh3', 'neo', 'bro'). ## `format` (type: `string`): Filter by format legality. ## `order` (type: `string`): How to sort results. ## Actor input object example ```json { "maxItems": 10, "query": "t:creature c:red", "order": "released" } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "query": "t:creature c:red", "order": "released" }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/scryfall-mtg-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "query": "t:creature c:red", "order": "released", } # Run the Actor and wait for it to finish run = client.actor("parseforge/scryfall-mtg-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "query": "t:creature c:red", "order": "released" }' | apify call parseforge/scryfall-mtg-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/scryfall-mtg-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Scryfall Magic The Gathering Scraper", "description": "Scrape Magic The Gathering card data including names, mana costs, types, rarity, images, pricing in USD and EUR, format legalities, and set details. Filter by text query, set code, or format. Covers 100,000+ unique cards across every MTG set.", "version": "1.0", "x-build-id": "326n1bVZxvvFFALph" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~scryfall-mtg-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-scryfall-mtg-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~scryfall-mtg-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-scryfall-mtg-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~scryfall-mtg-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-scryfall-mtg-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 cards. Paid users: Optional, max 1,000,000" }, "query": { "title": "Search Query", "type": "string", "description": "Scryfall search syntax. Examples: 'lightning bolt', 't:creature c:red', 'pow>=5', 'name:phoenix'" }, "set": { "title": "Set Code", "type": "string", "description": "Filter by set code (e.g. 'mh3', 'neo', 'bro')." }, "format": { "title": "Format", "enum": [ "", "standard", "pioneer", "modern", "legacy", "vintage", "commander", "pauper", "brawl" ], "type": "string", "description": "Filter by format legality." }, "order": { "title": "Sort Order", "enum": [ "released", "set", "name", "cmc", "power", "toughness", "edhrec", "usd", "eur", "artist" ], "type": "string", "description": "How to sort results." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```