Card Kingdom API & Scraper
The Card Kingdom API turns cardkingdom.com, the largest Magic: The Gathering singles store in the US, into JSON in four actions.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search finds printings by card name or edition and narrows them by rarity, colour, card type, format legality, foil, in-stock and a price bound, sorted by popularity, name or price, 25, 50 or 100 per page. Every row is one printing in one finish with the Card Kingdom product id, edition, rarity, collector number, mana cost, type, rules text, image and, for each of the four conditions (NM, EX, VG, G), the price, how many copies one order can take and the copies on the shelf. card returns one printing in full, with the card's other printings at Card Kingdom. buylist returns what Card Kingdom pays for a card in Near Mint: the cash offer and, separately, the store-credit offer, and the most copies it will buy. sets lists all 406 editions with the slug the other actions take. Prices are Card Kingdom's own, in US dollars. One ReefAPI key, the standard { ok, data, meta, error } envelope, no Card Kingdom account.
Condition prices relative to Near Mint — what Card Kingdom charges for played copies
Card Kingdom prices EX, VG and G as a share of the Near Mint price. Measured on 309 printings priced $1 or more on 2026-10-15; the API returns each condition's own price, so you never have to apply these ratios yourself.
| condition | share of the NM price | printings |
|---|---|---|
| EX (Excellent) | 80 % | 237 of 255 |
| EX (Excellent) | 90 % | 18 of 255 |
| VG (Very Good) | 70 % | 180 of 255 |
| VG (Very Good) | 60 % / 80 % | 57 / 18 of 255 |
| G (Good) | 50 % | 131 of 255 |
| G (Good) | 40 % / 60 % / 70 % | 57 / 49 / 18 of 255 |
A condition that is out of stock still carries its price (838 of 838 out-of-stock conditions had one), so in_stock tells you whether you can buy it. qty_available is the printed number Card Kingdom lets one order take (it stops at 8, 20 or 40); stock_qty is the larger shelf count the page carries alongside it.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/cardkingdom/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "lightning bolt"
}
}{
"ok": true,
"meta": {
"api": "cardkingdom",
"endpoint": "search",
"mode": "live",
"latency_ms": 1145.2,
"record_count": 25,
"bytes": 540898,
"cache_hit": false,
"total": 70,
"total_nonfoil": 70,
"total_foil": 13,
"page": 1,
"per_page": 25,
"has_more": true,
"past_last_page": false,
"sort": "popularity",
"filters_applied": {
"query": "lightning bolt",
"foil": false
},
"rows_from_related_editions": null,
"upstream_requests": 1,
"warnings": [],
"currency": "USD",
"charged_credits": 3,
"version": "1.0.0",
"request_id": "07e8f522f51648f2",
"queue_ms": 1.2,
"fetched_at": "2026-10-15T17:02:51.560Z"
},
"data": {
"rows": [
{
"id": "131524",
"path": "mtg/2011-core-set/lightning-bolt",
"url": "https://www.cardkingdom.com/mtg/2011-core-set/lightning-bolt",
"name": "Lightning Bolt",
"variation": null,
"edition": "2011 Core Set",
"edition_slug": "2011-core-set",
"rarity": "C",
"rarity_name": "Common",
"collector_number": "149",
"foil": false,
"listed_as_foil": false,
"mana_cost": "{R}",
"type_line": "Instant",
"power_toughness": null,
"rules_text": "Lightning Bolt deals 3 damage to any target.",
"image": "https://www.cardkingdom.com/images/magic-the-gathering/2011-core-set/lightning-bolt-62498.jpg",
"price_nm_usd": 2.99,
"in_stock": true,
"cheapest_in_stock": {
"condition": "EX",
"price_usd": 2.39
},
"conditions": [
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
}
]
},
{
"id": "127084",
"path": "mtg/2010-core-set/lightning-bolt",
"url": "https://www.cardkingdom.com/mtg/2010-core-set/lightning-bolt",
"name": "Lightning Bolt",
"variation": null,
"edition": "2010 Core Set",
"edition_slug": "2010-core-set",
"rarity": "C",
"rarity_name": "Common",
"collector_number": "146",
"foil": false,
"listed_as_foil": false,
"mana_cost": "{R}",
"type_line": "Instant",
"power_toughness": null,
"rules_text": "Lightning Bolt deals 3 damage to any target.",
"image": "https://www.cardkingdom.com/images/magic-the-gathering/2010-core-set/lightning-bolt-32673.jpg",
"price_nm_usd": 3.49,
"in_stock": true,
"cheapest_in_stock": {
"condition": "VG",
"price_usd": 2.44
},
"conditions": [
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
}
]
},
{
"id": "298206",
"path": "mtg/secret-lair/lightning-bolt-0021-gen-con-foil",
"url": "https://www.cardkingdom.com/mtg/secret-lair/lightning-bolt-0021-gen-con-foil",
"name": "Lightning Bolt (0021 - Gen Con Foil)",
"variation": "0021 - Gen Con Foil",
"edition": "Secret Lair",
"edition_slug": "secret-lair",
"rarity": "R",
"rarity_name": "Rare",
"collector_number": "0021",
"foil": true,
"listed_as_foil": false,
"mana_cost": "{R}",
"type_line": "Instant",
"power_toughness": null,
"rules_text": "Lightning Bolt deals 3 damage to any target.",
"image": "https://www.cardkingdom.com/images/magic-the-gathering/secret-lair/lightning-bolt-0021-gen-con-foil-52559.jpg",
"price_nm_usd": 74.99,
"in_stock": true,
"cheapest_in_stock": {
"condition": "NM",
"price_usd": 74.99
},
"conditions": [
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"condition_name": "[trimmed-depth]",
"price_usd": "[trimmed-depth]",
"price_printed_usd": "[trimmed-depth]",
"in_stock": "[trimmed-depth]",
"qty_available": "[trimmed-depth]",
"stock_qty": "[trimmed-depth]"
}
]
}
]
}
}What the Card Kingdom API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Card Kingdom's Magic singles: each row is one printing in one finish with its sell price and stock per condition (NM / EX / VG / G). Give `query` or `edition` (or both). Non-foil by default; foil=true for the foil printings. | Pricing teams call search to search Card Kingdom's Magic singles. | query, edition, rarity, foil, color, ... |
| card | One printing in one finish, in full: the sell price and stock of every condition, edition, rarity, collector number, mana cost, type, rules text, power/toughness and the card's other printings at Card Kingdom. | Marketplace operators call card to get one printing in one finish, in full. | path |
| buylist | Card Kingdom's buylist: what it pays for a card (Near Mint) in cash and, separately, in store credit, and how many copies it will buy. Give `query` or `edition` (or both). | Catalog enrichment teams call buylist to get card Kingdom's buylist. | query, edition, rarity, finish, format, ... |
| sets | Every Magic edition Card Kingdom lists, A-Z, with the slug `search` and `buylist` take as `edition`. | Retail analysts call sets to get every Magic edition Card Kingdom lists, A-Z, with the slug `search` and `buylist` take as `ed…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/cardkingdom/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lightning bolt"}'import requests
r = requests.post(
"https://api.reefapi.com/cardkingdom/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "lightning bolt"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/cardkingdom/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "lightning bolt"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.cardkingdom.search with {"query":"lightning bolt"}.Who uses this API and why
- Price a collection at US retail: search or card for each printing gives the NM, EX, VG and G price and whether it is in stock.
- Decide where to sell: buylist gives Card Kingdom's cash and store-credit offer and how many copies it buys, next to the TCGplayer or Cardmarket price.
- Find the cheapest playable copy: cheapest_in_stock across every printing of a card from one search.
- Watch a set's chase cards: search by edition with rarity M and sort by price, every day.
- Build a buylist arbitrage check: compare the sell price of one printing with the buylist cash offer for the same printing (same id and path).
Questions developers ask before integrating
Is the buylist store-credit price the same as cash?
No. buy_price_cash_usd is what Card Kingdom pays in cash and buy_price_credit_usd what it pays in store credit; they are separate fields and the credit offer is never returned as the price. On the rows measured the credit offer was 1.30 times the cash offer on most cards; on penny cards both are the same ($0.01). credit_to_cash_ratio is on every row.
Which conditions are covered?
Every printing comes with Near Mint (NM), Excellent (EX), Very Good (VG) and Good (G): price, whether it is in stock, the copies one order can take and the shelf count. cheapest_in_stock names the cheapest condition you can actually buy. The buylist quotes Near Mint only, as Card Kingdom's own buylist does.
How do foils work?
Non-foil and foil printings are separate rows with separate prices; foil=true in search returns the foil printings. Some promos exist only in foil (Gen Con, MagicFest, some Secret Lair drops) and Card Kingdom lists them with the regular singles; those rows have foil true and listed_as_foil false. In buylist, finish picks non-foil, foil or both.
How do I filter by set?
Pass an edition slug from sets (for example 2011-core-set or modern-horizons-3) as edition. Card Kingdom treats an edition as a family, so the answer can include related printings such as the set's commander decks, promos or variants; every row has its own edition_slug and meta.rows_from_related_editions says how many came from a related edition. An unknown slug is rejected instead of returning nothing.
How many results can I page through?
search and buylist return 25, 50 or 100 rows a page (per_page) with page numbers; meta.total is the source's own count (1,078 non-foil printings for dragon, 70 for lightning bolt) and has_more says whether another page exists. A page past the end returns no rows with past_last_page true.
Are the prices current?
Yes, every call reads Card Kingdom's live pages. On 2026-10-15 1,236 of 1,236 condition prices and 165 of 165 buylist cash offers matched Card Kingdom's own published price file. Prices are in US dollars and were the same from the US, the UK and Germany.
How do I get from a search row to the full card?
Every search and buylist row carries path (for example mtg/2011-core-set/lightning-bolt) and id, Card Kingdom's product id. Pass path to card as it is; the card comes back with the same id. A cardkingdom.com link works too.
Does it include price history or sealed product?
No. Card Kingdom publishes no price history or previous price, and sealed boxes, decks and graded cards are not part of this API. For price trends over time, call card on a schedule and keep the prices.
What is the Card Kingdom API?
Card Kingdom API is a ReefAPI endpoint group for card kingdom's magic: the gathering prices as json: what the largest us mtg store sells every printing for in nm, ex, vg and g with the copies on the shelf, and what it pays for a card in cash and in store credit. It returns live JSON through POST requests under /cardkingdom/v1.
Is the Card Kingdom API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Card Kingdom calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Card Kingdom login or account?
No login to Card Kingdom is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Card Kingdom data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Card Kingdom API use?
Card Kingdom actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Card Kingdom from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call cardkingdom actions with the same key, credit pool and JSON envelope used by normal REST requests.