Cardmarket APIcardmarket.com ↗
Access Cardmarket card prices, seller listings, expansions, price history, and best bargains across all major TCGs via a structured REST API.
What is the Cardmarket API?
This API covers 12 endpoints across Cardmarket, Europe's largest trading card marketplace, returning card prices, seller listings, expansion data, price history, and sealed product availability. get_card_listings delivers paginated seller offers with condition, price, and country filters, while get_price_history returns daily average sell prices alongside a full price guide summary for any specific card.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6e8ae7ea-a15a-4125-aada-1e116c8060b5/get_games' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the list of all supported trading card games on Cardmarket. Each game has a name and a slug used as identifier in other endpoints.
No input parameters required.
{
"type": "object",
"fields": {
"games": "array of game objects each with name (string) and slug (string)"
},
"sample": {
"data": {
"games": [
{
"name": "Magic: The Gathering",
"slug": "Magic"
},
{
"name": "Pokémon",
"slug": "Pokemon"
},
{
"name": "Yu-Gi-Oh!",
"slug": "YuGiOh"
},
{
"name": "One Piece Card Game",
"slug": "OnePiece"
},
{
"name": "Lorcana",
"slug": "Lorcana"
},
{
"name": "Star Wars: Unlimited",
"slug": "StarWarsUnlimited"
}
]
},
"status": "success"
}
}About the Cardmarket API
Card Data and Search
search_singles accepts a game slug (from get_games) and a keyword query, returning card name, expansion, rarity, available listing count, and lowest price across paginated results. get_card_details narrows to a specific card identified by game, expansion, and card slug, returning the full price guide fields — Price Trend, available items, and the first page of seller listings with condition, attributes, price, and quantity. get_card_versions lists every printing of a named card across all expansions, with per-version available_count, lowest_price, rarity, and a direct URL to that Singles page. Optional filters on seller_country, language, min_condition, and id_expansion apply to versions shown.
Listings and Pricing
get_card_listings paginates seller offers at 50 per page. Each listing object includes a listing_id, seller name, seller country, condition code, price, quantity, and comment. A retrievable_limit field signals the 300-article cap Cardmarket enforces; has_next indicates whether further pages exist. The seller_country integer filter (e.g. 7 for Germany) narrows results to sellers from a specific country. get_booster_box_listings applies the same pagination and filter model to sealed Booster Box products, also accepting a language string filter and returning a language_filter field confirming what was applied. get_price_history returns price_history as an array of chart objects — each with a label, period (30-day or 14-day), and data_points containing date and price — plus a price_guide object with 30-day, 7-day, and 1-day average prices.
Expansions and Catalog
get_expansions lists all sets for a game ordered by release date descending, with name, slug, card_count, and release_date. get_expansion_singles browses cards within a set, supporting sort, language, and min_condition filters; when those filters are active, lowest_price and available_count reflect only matching listings. get_best_bargains returns cards flagged as best-value deals for a given game, each with expansion name, URL, and current price.
Sellers and Sealed Products
get_seller_profile returns a seller's username and profile URL given a game slug and username. get_sealed_product_languages takes a numeric product_id and returns per-language listing counts, lowest prices, and a total_available rollup across all languages — useful for comparing availability across language variants of a sealed product.
The Cardmarket API is a managed, monitored endpoint for cardmarket.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cardmarket.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cardmarket.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price trends for specific Pokémon or Magic cards using
get_price_history30-day and 7-day averages - Build a cross-expansion price comparison tool using
get_card_versionswithmin_conditionandseller_countryfilters - Monitor seller offer counts and lowest prices across expansions using
get_expansion_singleswith language filters - Aggregate best bargain cards per game using
get_best_bargainsfor a daily deal tracker - Compare sealed booster box prices by language using
get_sealed_product_languageswith a numeric product ID - Build a seller reputation lookup by fetching seller usernames from listings and querying
get_seller_profile - Paginate all available listings for a high-demand card with
get_card_listingsand filter by country to surface local sellers
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Cardmarket have an official developer API?+
How many seller listings can I retrieve for a single card?+
get_card_listings returns up to 50 listings per page. Cardmarket enforces a hard cap of 300 retrievable articles per card, reflected in the retrievable_limit field. The has_next boolean indicates whether additional pages exist within that cap. total_available reports the full offer count as Cardmarket shows it, which may exceed 300.Can I filter card listings or expansion browsing by seller country?+
get_card_listings and get_booster_box_listings both accept a seller_country integer (e.g. 7 for Germany, 1 for Austria, 2 for Belgium). get_expansion_singles and get_card_versions support language and min_condition filters. Country-level filtering is not available on get_expansion_singles currently. You can fork the API on Parse and revise it to add that filter.Does the API expose buyer order history or personal account data?+
Are Yu-Gi-Oh and Magic: The Gathering both supported, or only Pokémon?+
get_games returns all games Cardmarket supports, which includes Pokémon, Magic: The Gathering, Yu-Gi-Oh, and others. The game slug returned by that endpoint is the identifier used across every other endpoint, so coverage follows whatever games Cardmarket lists.