# Cardmarket Yu-Gi-Oh! Trend Scraper (`scrap_them_all/cardmarket-yugioh-trend-scraper`) Actor Track Yu-Gi-Oh! TCG prices on Cardmarket — Europe's largest trading-card marketplace. Scrape Weekly Top Cards and Best Bargains. Returns ranked cards with stable productId, expansion, current EUR price, thumbnail and product URL. Built for arbitrage, price alerts and BI dashboards. - **URL**: https://apify.com/scrap\_them\_all/cardmarket-yugioh-trend-scraper.md - **Developed by:** [scrap\_them\_all](https://apify.com/scrap_them_all) (community) - **Categories:** Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Cardmarket Yu-Gi-Oh! Trend Scraper ### What does Cardmarket Yu-Gi-Oh! Trend Scraper do? This Actor scrapes **trending Yu-Gi-Oh! TCG cards** from [Cardmarket](https://www.cardmarket.com/en/YuGiOh) — Europe's largest trading-card marketplace. It supports both the **Weekly Top Cards** ranking (the most-sold singles of the week) and the **Best Bargains** list (cards currently priced below their long-term trend). Each result includes the card name, expansion, current EUR price and a direct product URL. Run it once from the Apify Console to try it, or call it from the [Apify API](https://docs.apify.com/api/v2) on any schedule, route the dataset into your warehouse, BI tool, or webhook — and let Apify rotate **residential proxies** and retry failed requests automatically so you never have to babysit a Cloudflare-protected site. ### Why use Cardmarket Yu-Gi-Oh! Trend Scraper? - **Spot price spikes early** — react to which Yu-Gi-Oh! singles are pumping this week before your competitors do. - **Source bargains** — surface cards trading well under their historical trend for arbitrage or personal collection. - **Power dashboards & alerts** — pipe structured JSON into Google Sheets, Airtable, Slack or your own backend. - **No bot-detection headaches** — Apify's residential proxy network handles Cardmarket's Cloudflare challenge for you. - **Stable schema** — built specifically for Cardmarket's trend pages, not a generic crawler. ### How to use Cardmarket Yu-Gi-Oh! Trend Scraper 1. Click **Try for free** on this Actor's page. 2. Pick **Weekly Top Cards** or **Best Bargains** in the *Page to scrape* dropdown. 3. (Optional) Choose a *Site language* and lower *Max results* to test cheaply. 4. Click **Start** — your first run is on the free tier. 5. Open the **Output** tab to download the dataset as JSON, CSV, Excel, or HTML. ### Input | Field | Type | Default | Description | | -------------------- | ------- | ---------------------------------- | ------------------------------------------------------------------------ | | `mode` | enum | `weekly-top-cards` | `weekly-top-cards` or `best-bargains` | | `language` | enum | `en` | Cardmarket UI language (`en`, `fr`, `de`, `es`, `it`) | | `maxResults` | integer | `100` | Cap on number of cards returned (1–500) | | `proxyConfiguration` | object | Apify Proxy, `RESIDENTIAL` group | Proxy settings — residential strongly recommended (Cloudflare-protected) | | `debugSaveHtml` | boolean | `false` | Save raw HTML to KV store under `PAGE_HTML` for selector debugging | ### Output ```json { "rank": 1, "cardName": "Blue-Eyes White Dragon (LOB-001)", "expansion": "Legend of Blue-Eyes White Dragon", "expansionUrl": "https://www.cardmarket.com/en/YuGiOh/Expansions/Legend-of-Blue-Eyes-White-Dragon", "currentPriceEur": 25.00, "imageUrl": "https://product-images.s3.cardmarket.com/3/LOB/123456/123456.jpg", "productId": 123456, "url": "https://www.cardmarket.com/en/YuGiOh/Products/Singles/Legend-of-Blue-Eyes-White-Dragon/Blue-Eyes-White-Dragon-LOB001", "scrapedAt": "2026-05-08T18:30:00.000Z", "sourceMode": "weekly-top-cards", "game": "YuGiOh" } ```` You can download the dataset in JSON, CSV, Excel, or HTML from the **Output** tab. ### Data table | Field | Type | Description | | ----------------- | ------- | ------------------------------------------------------------ | | `rank` | number | Position on the trend page (1-indexed) | | `cardName` | string | Full card title as listed by Cardmarket | | `expansion` | string | Set / expansion the card belongs to | | `expansionUrl` | string | Absolute URL to the expansion's Cardmarket page | | `currentPriceEur` | number | Current price in EUR | | `imageUrl` | string | Direct CDN URL to the card thumbnail (see hotlinking note) | | `productId` | number | Cardmarket internal numeric product ID (stable join key) | | `url` | string | Direct URL to the card's product page | | `scrapedAt` | string | ISO 8601 timestamp | | `sourceMode` | string | `weekly-top-cards` or `best-bargains` | | `game` | string | Always `YuGiOh` for this Actor | #### Image hotlinking — important Cardmarket's image CDN is fronted by CloudFront with **hotlink protection**. Loading `imageUrl` directly returns **HTTP 403** — the image only resolves when the request includes a `Referer` header set to a Cardmarket domain. - ✅ Server-side fetching (curl, fetch, ETL) with `Referer: https://www.cardmarket.com/` - ✅ Make / Zapier / n8n HTTP modules with custom `Referer` header - ❌ Direct embed in Notion, Airtable image columns, browser tab ### How much does it cost to scrape Cardmarket Yu-Gi-Oh! trends? Pay-Per-Event (PPE): a typical run of 100 cards costs around **$0.10**. The free tier covers thousands of results before you hit a paid plan. ### Tips and advanced options - Use `maxResults: 25` for a cheap smoke-test before scheduling a 500-row daily run. - Key on `productId` or `url` when joining with your own database. - Sister Actors cover **Pokémon TCG**, **Magic: The Gathering**, **Disney Lorcana**, **Flesh and Blood**, **Dragon Ball Super**, **One Piece** and **Riftbound** — same schema. ### FAQ, disclaimers and support **Is scraping Cardmarket legal?** This Actor extracts only publicly visible price information; you remain responsible for complying with Cardmarket's [Terms of Service](https://www.cardmarket.com/en/Magic/AboutUs/TermsAndConditions) and any applicable laws. **My run got blocked / returned 0 rows.** Cardmarket sits behind Cloudflare. Make sure `proxyConfiguration` uses the `RESIDENTIAL` group (the default). If issues persist, enable `debugSaveHtml: true` and inspect the dump. **Bug or custom variant?** Use the **Issues** tab on this Actor's page. # Actor input Schema ## `mode` (type: `string`): Which Cardmarket trend page to scrape. ## `language` (type: `string`): Cardmarket interface language. Affects URL prefix and label parsing. ## `maxResults` (type: `integer`): Maximum number of cards to extract from the page. Cardmarket trend pages typically list 50–100 entries. ## `proxyConfiguration` (type: `object`): Cardmarket sits behind Cloudflare. Residential proxies strongly recommended. ## `debugSaveHtml` (type: `boolean`): If enabled, the raw HTML response is saved to the key-value store under 'PAGE\_HTML' before parsing. Useful when validating selectors. ## Actor input object example ```json { "mode": "weekly-top-cards", "language": "en", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "debugSaveHtml": false } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrap_them_all/cardmarket-yugioh-trend-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], } } # Run the Actor and wait for it to finish run = client.actor("scrap_them_all/cardmarket-yugioh-trend-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrap_them_all/cardmarket-yugioh-trend-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrap_them_all/cardmarket-yugioh-trend-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cardmarket Yu-Gi-Oh! Trend Scraper", "description": "Track Yu-Gi-Oh! TCG prices on Cardmarket — Europe's largest trading-card marketplace. Scrape Weekly Top Cards and Best Bargains. Returns ranked cards with stable productId, expansion, current EUR price, thumbnail and product URL. Built for arbitrage, price alerts and BI dashboards.", "version": "1.0", "x-build-id": "uuinvqrOJzHCMnhdi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrap_them_all~cardmarket-yugioh-trend-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrap_them_all-cardmarket-yugioh-trend-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/scrap_them_all~cardmarket-yugioh-trend-scraper/runs": { "post": { "operationId": "runs-sync-scrap_them_all-cardmarket-yugioh-trend-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/scrap_them_all~cardmarket-yugioh-trend-scraper/run-sync": { "post": { "operationId": "run-sync-scrap_them_all-cardmarket-yugioh-trend-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", "required": [ "mode", "proxyConfiguration" ], "properties": { "mode": { "title": "Page to scrape", "enum": [ "weekly-top-cards", "best-bargains" ], "type": "string", "description": "Which Cardmarket trend page to scrape.", "default": "weekly-top-cards" }, "language": { "title": "Site language", "enum": [ "en", "fr", "de", "es", "it" ], "type": "string", "description": "Cardmarket interface language. Affects URL prefix and label parsing.", "default": "en" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of cards to extract from the page. Cardmarket trend pages typically list 50–100 entries.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Cardmarket sits behind Cloudflare. Residential proxies strongly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "debugSaveHtml": { "title": "Save raw HTML for debugging", "type": "boolean", "description": "If enabled, the raw HTML response is saved to the key-value store under 'PAGE_HTML' before parsing. Useful when validating selectors.", "default": 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 } } }, "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 } } } } } } } } } } ```