# Scryfall MTG Card Scraper (`crawlerbros/scryfall-mtg-card-scraper`) Actor Scrape Magic: The Gathering card data from the Scryfall API - card stats, prices (USD/EUR/MTGO), legalities, artwork, and full set listings. No API key required. - **URL**: https://apify.com/crawlerbros/scryfall-mtg-card-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Social media, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Scryfall MTG Card Scraper Scrape **[Scryfall](https://scryfall.com)** — the most comprehensive Magic: The Gathering card database. Get card stats, prices (USD, EUR, MTGO Tix), legalities across all formats, artwork, oracle text, and complete set listings. Powered by the free Scryfall API with no authentication required. ### Features - Search 30,000+ Magic: The Gathering cards by name, type, color, text - Real-time market prices: USD (TCGPlayer), EUR (Cardmarket), MTGO Tix - Format legality across 8 major formats (Standard, Modern, Legacy, Commander, etc.) - Complete card metadata: mana cost, CMC, type, oracle text, artist, collector number - Browse all cards from a specific set by set code - List all MTG sets with card counts and release dates - Get a random card for deck-building inspiration - High-resolution card image URLs from Scryfall's CDN ### Input | Field | Type | Description | |-------|------|-------------| | `mode` | select | `search` — card search; `bySet` — cards from a set; `sets` — all sets; `random` — random card | | `query` | String | Card name or Scryfall search syntax (e.g., `o:flying t:creature`) | | `setCode` | String | Set code for bySet mode (e.g., `mh3`, `lea`, `neo`) | | `colors` | String | Color filter: W/U/B/R/G or combinations (e.g., `WU`, `BRG`) | | `rarity` | select | Filter by rarity: common/uncommon/rare/mythic | | `cardType` | select | Filter by type: creature/instant/sorcery/enchantment/artifact/land/planeswalker | | `sortBy` | select | Sort: name/released/cmc/edhrec/usd/tix | | `maxItems` | Integer | Max cards to return (1–500, default 20) | ### Output Each card record contains: | Field | Type | Description | |-------|------|-------------| | `cardId` | String | Scryfall UUID | | `name` | String | Card name | | `setCode` | String | Set abbreviation (e.g., `mh3`) | | `setName` | String | Full set name | | `collectorNumber` | String | Collector number within the set | | `rarity` | String | common/uncommon/rare/mythic | | `typeLine` | String | Full type line | | `manaCost` | String | Mana cost string (e.g., `{2}{W}{W}`) | | `cmc` | Float | Converted mana cost | | `oracleText` | String | Rules text | | `colors` | Array | Color symbols (W, U, B, R, G) | | `colorIdentity` | Array | Commander color identity | | `keywords` | Array | Keyword abilities | | `power` | String | Power (creatures) | | `toughness` | String | Toughness (creatures) | | `loyalty` | String | Loyalty (planeswalkers) | | `artist` | String | Card artist name | | `imageUrl` | String | High-res card image URL | | `priceUsd` | Float | Current TCGPlayer price (USD) | | `priceUsdFoil` | Float | Foil price (USD) | | `priceEur` | Float | Current Cardmarket price (EUR) | | `priceTix` | Float | MTGO Tix price | | `legalIn` | Array | Formats where the card is legal | | `reserved` | Boolean | On the Reserved List | | `cardUrl` | String | Scryfall card page URL | | `releasedAt` | String | First print date | | `scrapedAt` | String | Scrape timestamp (ISO 8601) | ### Example Input ```json { "mode": "search", "query": "Black Lotus", "maxItems": 20 } ```` ```json { "mode": "bySet", "setCode": "mh3", "sortBy": "usd", "maxItems": 100 } ``` ```json { "mode": "search", "query": "o:flying", "colors": "WU", "rarity": "rare", "cardType": "creature", "maxItems": 50 } ``` ### Example Output ```json { "cardId": "4c85d097-e87b-41ee-93c6-0e54ec41b174", "name": "Black Lotus", "setCode": "lea", "setName": "Limited Edition Alpha", "collectorNumber": "233", "rarity": "rare", "typeLine": "Artifact", "manaCost": "{0}", "cmc": 0.0, "oracleText": "{T}, Sacrifice Black Lotus: Add three mana of any one color.", "artist": "Christopher Rush", "imageUrl": "https://cards.scryfall.io/normal/front/...", "priceUsd": 24999.99, "reserved": true, "legalIn": ["vintage"], "cardUrl": "https://scryfall.com/card/lea/233/black-lotus", "releasedAt": "1993-08-05", "scrapedAt": "2026-06-10T12:00:00+00:00" } ``` ### Scryfall Search Syntax Scryfall supports powerful search operators in the `query` field: - `t:creature` — card type contains "creature" - `o:flying` — oracle text contains "flying" - `c:WU` — White and Blue cards - `cmc=3` — converted mana cost equals 3 - `r:mythic` — mythic rarity - `set:mh3` — from Modern Horizons 3 - `a:"Terese Nielsen"` — by artist ### Use Cases - **Deck builders**: Find cards matching specific criteria for Commander or competitive play - **Price tracking**: Monitor card prices across standard formats and new set releases - **Collection managers**: Catalog your collection with full card metadata - **Set investors**: Analyze complete set value breakdowns sorted by price - **Game developers**: Access comprehensive card data for MTG apps and tools ### FAQ **Is an API key required?** No. The Scryfall API is completely free and requires no authentication. **How current are the prices?** Prices are updated daily from TCGPlayer (USD) and Cardmarket (EUR). **Can I fetch all cards from a specific set?** Yes — use `mode: bySet` with the set code (e.g., `mh3` for Modern Horizons 3). **What is the maximum number of cards I can retrieve?** Up to 500 per run. Scryfall paginates at 175 cards per page. # Actor input Schema ## `mode` (type: `string`): What to fetch from Scryfall. ## `query` (type: `string`): Card name or Scryfall search syntax (e.g., 'Black Lotus', 'o:flying t:creature'). Used in search mode. ## `setCode` (type: `string`): MTG set code to fetch all cards from (e.g., 'mh3', 'lea', 'neo'). Used in bySet mode. ## `colors` (type: `string`): Filter by color identity. Use W (White), U (Blue), B (Black), R (Red), G (Green) or combinations like 'WU', 'BRG'. ## `rarity` (type: `string`): Filter by card rarity. ## `cardType` (type: `string`): Filter by card type. ## `sortBy` (type: `string`): Sort order for results. ## `maxItems` (type: `integer`): Maximum number of cards/sets to return (1–500). ## Actor input object example ```json { "mode": "search", "query": "Black Lotus", "setCode": "mh3", "rarity": "any", "cardType": "any", "sortBy": "name", "maxItems": 20 } ``` # Actor output Schema ## `results` (type: `string`): Dataset of Magic: The Gathering cards from api.scryfall.com. # 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 = { "mode": "search", "query": "Black Lotus", "setCode": "mh3", "sortBy": "name", "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/scryfall-mtg-card-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 = { "mode": "search", "query": "Black Lotus", "setCode": "mh3", "sortBy": "name", "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/scryfall-mtg-card-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 '{ "mode": "search", "query": "Black Lotus", "setCode": "mh3", "sortBy": "name", "maxItems": 20 }' | apify call crawlerbros/scryfall-mtg-card-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/scryfall-mtg-card-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Scryfall MTG Card Scraper", "description": "Scrape Magic: The Gathering card data from the Scryfall API - card stats, prices (USD/EUR/MTGO), legalities, artwork, and full set listings. No API key required.", "version": "1.0", "x-build-id": "ufZ2woRHaNnZFoJOG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~scryfall-mtg-card-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-scryfall-mtg-card-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/crawlerbros~scryfall-mtg-card-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-scryfall-mtg-card-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/crawlerbros~scryfall-mtg-card-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-scryfall-mtg-card-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "bySet", "sets", "random" ], "type": "string", "description": "What to fetch from Scryfall.", "default": "search" }, "query": { "title": "Search Query", "type": "string", "description": "Card name or Scryfall search syntax (e.g., 'Black Lotus', 'o:flying t:creature'). Used in search mode.", "default": "Black Lotus" }, "setCode": { "title": "Set Code", "type": "string", "description": "MTG set code to fetch all cards from (e.g., 'mh3', 'lea', 'neo'). Used in bySet mode." }, "colors": { "title": "Color Filter", "type": "string", "description": "Filter by color identity. Use W (White), U (Blue), B (Black), R (Red), G (Green) or combinations like 'WU', 'BRG'." }, "rarity": { "title": "Rarity", "enum": [ "any", "common", "uncommon", "rare", "mythic" ], "type": "string", "description": "Filter by card rarity.", "default": "any" }, "cardType": { "title": "Card Type", "enum": [ "any", "creature", "instant", "sorcery", "enchantment", "artifact", "land", "planeswalker", "battle" ], "type": "string", "description": "Filter by card type.", "default": "any" }, "sortBy": { "title": "Sort By", "enum": [ "name", "released", "cmc", "edhrec", "usd", "tix" ], "type": "string", "description": "Sort order for results.", "default": "name" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of cards/sets to return (1–500).", "default": 20 } } }, "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 } } } } } } } } } } ```