cardkingdom.com APIcardkingdom.com ↗
Access Magic: The Gathering card prices, buylist rates, edition catalogs, and deals from Card Kingdom via 6 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/57fad8b8-9bec-4fbf-9dfd-c5d328040d29/search_cards?query=Lightning+Bolt' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Magic: The Gathering cards by name, edition, and format. Returns paginated results with pricing and condition availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| query | string | Search keyword for card name (e.g. 'Lightning Bolt') |
| format | string | Filter by tournament format: Commander, Legacy, Modern, Pauper, Vintage, Pioneer, Brawl, Standard, Premodern |
| edition | string | Filter by card set/edition name |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"items": "array of card objects with name, url, edition, rarity, type, oracle_text, and conditions (price/availability per condition)",
"per_page": "integer, results per page"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.cardkingdom.com/mtg/beta/lightning-bolt",
"name": "Lightning Bolt",
"type": "Instant",
"rarity": "C",
"edition": "Beta",
"conditions": [
{
"price": "$449.99",
"available": "0",
"condition": "NM"
},
{
"price": "$359.99",
"available": "3",
"condition": "EX"
}
],
"oracle_text": "Lightning Bolt deals 3 damage to any target.",
"collector_number": "162"
}
],
"per_page": 100
},
"status": "success"
}
}About the cardkingdom.com API
The Card Kingdom API provides structured access to Magic: The Gathering card data across 6 endpoints, covering retail prices, buylist rates, edition listings, and current deals. The search_cards endpoint lets you query cards by name, format, or edition and returns per-condition pricing and availability. Additional endpoints expose full card details, sell-to-store buylist prices in both cash and store credit, and a complete catalog of MTG sets.
Card Search and Detail
The search_cards endpoint accepts a query string for card name lookup, an edition filter for set-specific results, and a format filter supporting nine tournament formats including Commander, Modern, Legacy, Pioneer, and Standard. Results are paginated via the page parameter and each item includes the card's name, edition, rarity, type, oracle_text, and a conditions array containing price and availability per grading condition. For deeper data, get_card_detail takes a card url path and returns the full conditions list with quantities, the card's oracle text, and an other_versions array linking to alternate printings of the same card.
Buylist and Deals
The get_buylist_prices endpoint returns what Card Kingdom will pay for cards — each item in the response includes buylist_prices with distinct cash, credit, and max_quantity fields. You can filter by query or edition and paginate results. The get_deals endpoint surfaces currently discounted products with original_price, sale_price, and a direct url to the listing, making it straightforward to track markdown events across the catalog.
Editions and Formats Reference
list_all_editions returns the full MTG set catalog as an array of objects with name, slug, and url — useful for building edition pickers or validating set names before passing them to search_cards or get_buylist_prices. get_formats returns a keyed object of all supported game formats with each format's id, name, slug, and is_active status, giving you the canonical format identifiers Card Kingdom recognizes.
- Compare retail prices across card conditions to find the lowest-cost copy of a specific printing
- Track buylist cash vs. store credit rates to identify the best time to sell cards back
- Monitor the deals feed for price drops on specific cards or products
- Build a format-legality price checker using the format filter in search_cards
- Generate a full set inventory by iterating search_cards with an edition parameter from list_all_editions
- Alert on buylist max_quantity limits to detect when Card Kingdom stops buying a given card
- Cross-reference other_versions from get_card_detail to find cheaper alternate printings of a card
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Card Kingdom have an official developer API?+
What does the buylist endpoint actually return — and how does it differ from retail pricing?+
get_buylist_prices endpoint returns what Card Kingdom will pay when you sell cards to them, not what they charge buyers. Each item includes a buylist_prices object with separate cash and credit values and a max_quantity field indicating how many copies they are currently buying. Retail sell prices come from search_cards or get_card_detail via the conditions array.Does the API cover foil or special-treatment card variants separately?+
conditions arrays in search_cards and get_card_detail reflect the condition grades and quantities Card Kingdom lists. Foil and non-foil versions of a card typically appear as separate listings, accessible via get_card_detail with the relevant url or through the other_versions field. Explicit foil flags are not a dedicated response field currently. You can fork the API on Parse and revise it to add a foil-specific filter or field if that distinction matters to your use case.Is historical price data available through any of the endpoints?+
How does pagination work across endpoints that support it?+
search_cards, get_buylist_prices, and get_deals all accept an integer page parameter. Each response includes the current page number and a per_page count so you can calculate total pages from the result set size. list_all_editions and get_formats return their full datasets in a single response with no pagination.