Scryfall MTG Card Scraper

Scrape Scryfall — 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

{
  "mode": "search",
  "query": "Black Lotus",
  "maxItems": 20
}

{
  "mode": "bySet",
  "setCode": "mh3",
  "sortBy": "usd",
  "maxItems": 100
}

{
  "mode": "search",
  "query": "o:flying",
  "colors": "WU",
  "rarity": "rare",
  "cardType": "creature",
  "maxItems": 50
}

Example Output

{
  "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.