Cardmarket product offers

GET https://api.api.sh/cardmarket/v1/offers
1 credit / call e-commerce try it in the playground →

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

nametypedescription
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"

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).

The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.