MTGMintCard Scraper

Scrape MTGMintCard — a long-running Magic: The Gathering singles retailer — for live card listings: card name, set/edition, condition, price (USD), foil, stock quantity, card type, image and product URL.

Search by card name, browse whole sets by set code, or both. Each card can list multiple condition variants (e.g. NM and PLD) and each becomes its own row with its own price and stock.

What it does

• Card-name search — e.g. Lightning Bolt, Ragavan. Returns every matching printing/condition across all sets (regular, foil and graded printings all appear).
• Set browsing — give a set code (found in the URL mtgmintcard.com/mtg/singles/<code>), e.g. mh3, eld, ltr, blb, and the actor paginates through the full set. With Include Foil on it also crawls the foil printings.
• Server-rendered HTML — no login, no proxy required.

Input

Field	Type	Description
searchQueries	array of strings	Card names to search (e.g. ["Lightning Bolt", "Ragavan"]).
setCodes	array of strings	Set codes to browse in full (e.g. ["mh3", "eld"]).
includeFoil	boolean	Also crawl foil (eng-foil) variants when browsing sets. Default true.
maxItems	integer	Max singles per query/set. Default 200.
onlyInStock	boolean	Only return listings that currently have stock. Default false.
proxyConfiguration	object	Optional proxy. Usually not needed.

Provide searchQueries, setCodes, or both. If neither is given, it defaults to searching Lightning Bolt.

Example input

{
  "searchQueries": ["Lightning Bolt", "Ragavan"],
  "setCodes": ["mh3"],
  "includeFoil": true,
  "maxItems": 200,
  "onlyInStock": false
}

Output

Each dataset item is one card-condition listing:

{
  "productId": "662413",
  "name": "Lightning Bolt",
  "game": "Magic: The Gathering",
  "set": "Masters 25",
  "setCode": "a25",
  "cardType": "Instant",
  "condition": "PLD",
  "finish": "regular",
  "foil": false,
  "price": 209.99,
  "currency": "USD",
  "priceText": "$209.99",
  "inStock": true,
  "stockQuantity": 3,
  "availability": "In Stock",
  "image": "https://www.mtgmintcard.com/images/mtg/singles/a25/eng-reg/LIGHTNING-BOLT.jpg",
  "url": "https://www.mtgmintcard.com/mtg/singles/a25/eng-reg/lightning-bolt",
  "searchQuery": "Lightning Bolt",
  "setBrowsed": null,
  "source": "mtgmintcard.com",
  "scrapedAt": "2026-08-11T06:43:42.000Z"
}

Field notes

• condition — grade code used by the store (e.g. NM near mint, PLD played).
• finish — regular, foil or graded (derived from the listing variant).
• stockQuantity — max purchasable quantity exposed by the store (may be capped by the site).
• price is in USD.

Use cases

• Track MTG single prices for arbitrage against TCGplayer / Card Kingdom / Cardmarket.
• Monitor stock and price changes on specific cards.
• Build set-level price datasets for deck-building and collection valuation.

Notes

The actor is QA-safe: it never throws on empty input, enforces a wall-clock deadline, and if nothing is found it writes a DIAGNOSTIC record to the key-value store instead of billing an error row. Please scrape responsibly and respect MTGMintCard's Terms of Service.