{ "openapi": "3.0.1", "info": { "title": "Cardmarket Scraper - Price Guide, Seller Offers & Top Cards", "description": "Scrape Cardmarket for 23 trading card games: the daily price guide (trend, low, 1/7/30-day averages, foil) for every card and sealed product, live seller offers with condition, language, price, quantity, seller type and country, seller shops, and the Best Sellers / Best Bargains lists.", "version": "0.1", "x-build-id": "Isk9bfWy5DXILIhbG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~cardmarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-cardmarket-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapersdelight~cardmarket-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-cardmarket-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapersdelight~cardmarket-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-cardmarket-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "products", "offers", "topCards" ], "type": "string", "description": "Price guide = Cardmarket's daily prices for every product of a game (fast). Offers = live seller offers from product pages or seller shops. Top cards = Best Sellers / Best Bargains lists.", "default": "products" }, "game": { "title": "Game", "enum": [ "pokemon", "magic", "yugioh", "onepiece", "lorcana", "digimon", "fleshandblood", "starwarsunlimited", "dragonballsuper", "riftbound", "gundam", "sorcery", "cyberpunk", "battlespiritssaga", "finalfantasy", "forceofwill", "vanguard", "weissschwarz", "starwarsdestiny", "worldofwarcraft", "mylittlepony", "dragoborne", "thespoils" ], "type": "string", "description": "The trading card game. Product URLs and seller URLs carry their own game; this one is used for keywords, product ids, seller names and lists.", "default": "pokemon" }, "searchQueries": { "title": "Card or product names", "type": "array", "description": "Name filters (every word must appear, case and accents ignored), e.g. \"charizard\", \"black lotus\", \"booster box\". Empty = the whole game in price-guide mode. In offers mode each name opens its top products (see Products per name).", "items": { "type": "string" } }, "productUrls": { "title": "Product or seller URLs", "type": "array", "description": "Offers mode: Cardmarket product pages (filters in the URL are kept), e.g. https://www.cardmarket.com/en/Magic/Products/Singles/Alpha/Lightning-Bolt, or seller pages (/Users//Offers/Singles).", "items": { "type": "string" } }, "productIds": { "title": "Product ids", "type": "array", "description": "Cardmarket product ids (productId in every row), e.g. 5395. Price-guide mode returns exactly these; offers mode opens their pages.", "items": { "type": "string" } }, "sellerUsernames": { "title": "Seller shops", "type": "array", "description": "Offers mode: seller usernames whose shop (Singles) to walk for the chosen game, e.g. \"CardGameCorner\". 20 offers per page.", "items": { "type": "string" } }, "topCardsLists": { "title": "Top-card lists", "type": "array", "description": "Top-cards mode: which of Cardmarket's lists to read for the game (about 100 cards each).", "items": { "type": "string", "enum": [ "bestSellers", "bestBargains" ], "enumTitles": [ "Best Sellers (Weekly Top Cards)", "Best Bargains" ] }, "default": [ "bestSellers" ] }, "productType": { "title": "Products", "enum": [ "singles", "sealed", "all" ], "type": "string", "description": "Single cards, sealed products (booster boxes, boosters, decks, tins, sets) or both.", "default": "singles" }, "expansions": { "title": "Expansions", "type": "array", "description": "Keep only these sets, by name as Cardmarket shows it or by expansionId, e.g. \"151\", \"Alpha\", 5320. Empty = all sets.", "items": { "type": "string" } }, "languages": { "title": "Card languages", "type": "array", "description": "Offers: only these print languages, e.g. \"English\", \"Japanese\". Values: English, French, German, Spanish, Italian, S-Chinese, Japanese, Portuguese, Russian, Korean, T-Chinese, Indonesian, Thai.", "items": { "type": "string" } }, "minCondition": { "title": "Minimum condition", "enum": [ "any", "MT", "NM", "EX", "GD", "LP", "PL", "PO" ], "type": "string", "description": "Offers: this grade or better (sealed products have no grade and are not affected).", "default": "any" }, "sellerCountries": { "title": "Seller countries", "type": "array", "description": "Offers: only items located in these countries, ISO code or name, e.g. \"DE\", \"FR\", \"United Kingdom\". Empty = all 35 Cardmarket countries.", "items": { "type": "string" } }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "professional", "powerseller", "commercial" ], "type": "string", "description": "Offers: private, professional, powerseller, or commercial (professional + powerseller).", "default": "any" }, "foil": { "title": "Foil", "enum": [ "any", "foil", "nonFoil" ], "type": "string", "description": "Offers: foil only or non-foil only (games with a foil filter, e.g. Magic).", "default": "any" }, "isReverseHolo": { "title": "Reverse holo only", "type": "boolean", "description": "Offers: only reverse-holo copies (Pokémon).", "default": false }, "isSigned": { "title": "Signed only", "type": "boolean", "description": "Offers: only signed copies.", "default": false }, "isAltered": { "title": "Altered only", "type": "boolean", "description": "Offers: only altered-art copies.", "default": false }, "isFirstEd": { "title": "First edition only", "type": "boolean", "description": "Offers: only first-edition copies (Yu-Gi-Oh!).", "default": false }, "minQuantity": { "title": "Minimum quantity", "minimum": 0, "maximum": 100, "type": "integer", "description": "Offers: only listings with at least this many copies, e.g. 4 for a playset. 0 = any.", "default": 0 }, "shopQuery": { "title": "Shop card name", "type": "string", "description": "Seller shops: only cards whose name contains this text (Cardmarket's own shop search), e.g. \"bolt\". Empty = the whole shop." }, "shopSort": { "title": "Shop sort", "enum": [ "best_match", "price_asc", "price_desc", "name_asc" ], "type": "string", "description": "Seller shops: order of the shop pages.", "default": "best_match" }, "priceMinEur": { "title": "Min trend price (EUR)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Price guide / keyword products: keep products whose trend price is at least this, e.g. 5. Empty = no lower bound." }, "priceMaxEur": { "title": "Max trend price (EUR)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Price guide / keyword products: keep products whose trend price is at most this, e.g. 500. Empty = no upper bound." }, "onlyPriced": { "title": "Only priced products", "type": "boolean", "description": "Skip products with no trend price (regular or foil) in today's price guide.", "default": true }, "minPrice": { "title": "Min offer price (EUR)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Offers: drop listings cheaper than this, e.g. 1." }, "maxPrice": { "title": "Max offer price (EUR)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Offers: drop listings dearer than this, e.g. 50." }, "sortBy": { "title": "Sort products by", "enum": [ "trendDesc", "trendAsc", "momentum", "momentumDown", "name", "newest" ], "type": "string", "description": "Order of price-guide rows, and which products a name opens first in offers mode.", "default": "trendDesc" }, "includeProductRows": { "title": "Product row per page", "type": "boolean", "description": "Offers mode: also deliver one product row per page read (rarity, number, available items, from price, trend, 1/7/30-day averages, image, price history), billed as a product row.", "default": true }, "maxOffersPerProduct": { "title": "Offers per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Offers mode: Cardmarket shows the 50 cheapest offers per page; above 50 the actor reads more pages split by language, seller type and country (one page each).", "default": 50 }, "includePriceGuide": { "title": "Join the price guide", "type": "boolean", "description": "Top-cards mode: add each card's trend, low, average and foil prices from Cardmarket's daily price guide.", "default": true }, "trackChanges": { "title": "Track price changes", "type": "boolean", "description": "Price guide: add changeStatus (NEW, PRICE_UP, PRICE_DOWN, UNCHANGED), the previous trend price and the % change since your last delivered run.", "default": false }, "onlyChanged": { "title": "Only changed products", "type": "boolean", "description": "Price guide: deliver (and bill) only products that are new or whose trend price moved since your last run. Turns on change tracking.", "default": false }, "changeStoreName": { "title": "Price history store", "type": "string", "description": "Named key-value store that keeps the last delivered trend per product. Use a different name per watch list.", "default": "cardmarket-price-history" }, "monitorMode": { "title": "Only new offers", "type": "boolean", "description": "Offers: deliver only offers not delivered by an earlier run with the same filters (first run = full baseline).", "default": false }, "monitorStoreName": { "title": "Offer monitor store", "type": "string", "description": "Named key-value store for the offer ids already delivered.", "default": "cardmarket-offers-monitor" }, "maxResults": { "title": "Max results", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Most rows to deliver: products (price guide), offers (offers mode) or top cards. 0 = no cap (a whole game is 1,000-125,000 products).", "default": 100 }, "maxProducts": { "title": "Products per name", "minimum": 1, "maximum": 200, "type": "integer", "description": "Offers mode: how many products each card name opens, best first by the chosen sort (one page each).", "default": 3 }, "skipItems": { "title": "Skip rows", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Price guide: skip the first N sorted rows, to page through a whole game across runs.", "default": 0 }, "maxShopPages": { "title": "Shop pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Seller shops: pages to read per seller (20 offers each).", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Price files are read directly; Cardmarket's pages come through Apify's Unblocker. A proxy set here is tried once per run before it.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }