Cardmarket product offers
The marketplace page of one product: name, rarity, expansion, number of versions, available items, from price, price trend and 1/7/30-day averages, rules text, image, the average sell price history, and the current offers (cheapest first): offer id, seller username, seller type (private, professional, powerseller), seller sales and available items, item location, condition, language, extras (foil, signed, altered, first edition ...), the seller's comment, price (EUR), quantity and the seller's scan when there is one. Filter like the site: language, seller country and type, minimum condition, foil, signed, altered, first edition, reverse holo, playset, minimum quantity. Pass a product page link as url, or game and the product id. Logged out, Cardmarket shows the first 50 offers for the chosen filters; more_offers_hidden is true when there are more (narrow them with the filters).
Every response includes credits_used: the credits this call cost.
Part of the Cardmarket API: 11 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
url | string | Product page link on cardmarket.com (or its path). Example: https://www.cardmarket.com/en/Magic/Products/Singles/Alpha/Black-Lotus |
id | string | Product id instead of url (with game). |
game | string | Game key (default magic): magic, pokemon, yugioh, one-piece, lorcana, flesh-and-blood, digimon, dragon-ball-super, star-wars-unlimited, riftbound, gundam, sorcery and the other games in /cardmarket/v1/games (aliases: mtg, ygo, fab). Example: magic |
language | string | Card language(s), comma-separated: names (english, french, german, spanish, italian, japanese, portuguese, russian, korean, s-chinese, t-chinese) or ids 1-11. |
seller_country | string | Seller country/countries: two-letter codes (DE, FR, IT, ES, GB, NL, AT, BE ...) or Cardmarket country ids, comma-separated. |
seller_type | string | private, professional, powerseller (comma-separated) or ids 0-2. |
min_condition | string | Lowest condition: MT, NM, EX, GD, LP, PL, PO (or 1-7). |
foil | boolean | true or false (games with foil printings). |
signed | boolean | true or false. |
altered | boolean | true or false. |
first_edition | boolean | true or false (Yu-Gi-Oh! and other games with first editions). |
reverse_holo | boolean | true or false (Pokemon). |
playset | boolean | true or false (Magic playsets of four). |
min_quantity | integer | Only offers with at least this many copies (1-40). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/cardmarket/v1/offers?url=https%3A%2F%2Fwww.cardmarket.com%2Fen%2FMagic%2FProducts%2FSingles%2FAlpha%2FBlack-Lotus" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/cardmarket/v1/offers",
params={"url": "https://www.cardmarket.com/en/Magic/Products/Singles/Alpha/Black-Lotus"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/cardmarket/v1/offers");
url.searchParams.set("url", "https://www.cardmarket.com/en/Magic/Products/Singles/Alpha/Black-Lotus");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).