# European Price Comparison - Compare Prices Across EU Engines (`studio-amba/european-price-comparison`) Actor Search 10 European price-comparison engines at once and compare prices for any product. Groups by EAN barcode, converts to EUR. No login or cookies required. - **URL**: https://apify.com/studio-amba/european-price-comparison.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## European Price Comparison Compare product prices across ten European price-comparison engines in a single run. This actor searches each engine in parallel, groups the results by EAN/GTIN barcode (with a fuzzy product-name fallback), and converts every price to EUR using live ECB rates so you can see the cheapest source across borders. No login. No cookies. No account. You give it a product, it gives you a side-by-side comparison. ### What it does - Searches 10 European price engines at once: Akakçe (TR), Cimri (TR), Ceneo (PL), Compari (RO), Geizhals (AT), Heureka (CZ), Kelkoo (FR), Pazaruvaj (BG), PriceRunner (SE), Zboží (CZ). - Matches the same product across engines by EAN barcode, then falls back to fuzzy name matching when no barcode is present. - Converts all prices to EUR with live European Central Bank rates, so a Turkish lira price and a Polish złoty price are directly comparable. - Returns the lowest price, highest price, and the percentage spread for each matched product. - Sorts results so products found in the most engines appear first. ### How to scrape European price comparison data 1. Enter a product in the **Search Query** field. Use the brand and model for the best cross-engine matching, for example `iphone 15`, `sony wh-1000xm5`, or `dyson v15`. 2. Optionally restrict the run to certain countries with the **Countries** field (for example `["AT", "CZ"]`). Leave it empty to query every engine. 3. Set **Max Items Per Source** to control how many products are pulled from each engine. More items means more potential matches but a longer, costlier run. 4. Run the actor. Each engine is queried in parallel, the results are grouped by EAN, and prices are converted to EUR. 5. Open the dataset. Each row is one product with the prices found at every engine that carries it. ### Input | Field | Type | Description | |-------|------|-------------| | `searchQuery` | string | Product to search for across all engines. Defaults to `iphone 15`. | | `countries` | array | Optional country filter (`TR`, `PL`, `RO`, `AT`, `CZ`, `FR`, `BG`, `SE`). Empty means all. | | `maxItemsPerSource` | integer | Max products to fetch from each engine (1–100, default 10). | | `timeoutPerSourceSecs` | integer | Max seconds to wait for each engine (30–600, default 120). | | `proxyConfiguration` | object | Proxy settings passed to the underlying scrapers. Residential recommended. | #### Example input ```json { "searchQuery": "sony wh-1000xm5", "countries": ["AT", "CZ", "PL"], "maxItemsPerSource": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Output Each item in the dataset is one matched product: ```json { "productName": "Sony WH-1000XM5 Wireless Headphones", "ean": "4548736141537", "lowestPriceEur": 289.0, "highestPriceEur": 349.99, "priceDifference": "21.1%", "sourceCount": 4, "prices": [ { "source": "Geizhals", "country": "AT", "price": 289.0, "currency": "EUR", "priceEur": 289.0, "url": "https://...", "inStock": true }, { "source": "Heureka", "country": "CZ", "price": 7290, "currency": "CZK", "priceEur": 291.6, "url": "https://...", "inStock": true } ], "scrapedAt": "2026-06-15T18:00:00.000Z" } ``` | Field | Description | |-------|-------------| | `productName` | Canonical product name from the most detailed source. | | `ean` | EAN/GTIN barcode used for matching, or `null` if name-matched. | | `lowestPriceEur` | Lowest price across all sources, in EUR. | | `highestPriceEur` | Highest price across all sources, in EUR. | | `priceDifference` | Percentage spread between highest and lowest EUR price. | | `sourceCount` | How many engines carry this product. | | `prices` | Per-source price entries with native currency and EUR conversion. | | `scrapedAt` | ISO 8601 timestamp of the comparison. | A final `__SUMMARY__` item lists which sources answered, which failed, and the total number of comparisons. ### How matching works Products are grouped first by EAN/GTIN barcode, which is an exact identifier and the most reliable signal. Products without a barcode are matched to existing groups by name similarity (Jaccard word overlap, threshold 0.6) and otherwise start a new group. This keeps false merges low while still consolidating items that lack barcodes. ### Currency conversion Prices arrive in each engine's local currency. The actor fetches live EUR reference rates from the European Central Bank at the start of every run and converts each price to EUR for comparison. If the rate service is unreachable, it falls back to a built-in rate table so the run still completes. Native price and currency are always preserved alongside the EUR value. ### Use cases - Cross-border price monitoring for electronics and consumer goods. - Finding the cheapest EU source for a specific product before buying. - Feeding a price-intelligence dashboard with normalized, EUR-denominated data. - Spotting arbitrage between countries where the same product sells at very different prices. ### Notes - This is a meta-actor. It orchestrates our individual country price-engine scrapers and runs them in parallel, so a single run can touch many sites at once. - Results depend on each underlying engine carrying the product and returning it for your query. Generic queries match more broadly; specific brand+model queries match more accurately. - Use residential proxies for the most reliable results, since some engines are sensitive to datacenter traffic. # Actor input Schema ## `searchQuery` (type: `string`): Product to search for across all price engines (e.g., 'iphone 15', 'sony wh-1000xm5', 'dyson v15'). Use the brand and model for best matching. ## `countries` (type: `array`): Filter which countries to include. Leave empty to search all available engines (TR, PL, RO, AT, CZ, FR, BG, SE). ## `maxItemsPerSource` (type: `integer`): Maximum number of products to fetch from each price engine. Higher values give more matches but take longer and cost more. ## `timeoutPerSourceSecs` (type: `integer`): Maximum time to wait for each underlying scraper to finish. Sources that take longer are skipped. ## `proxyConfiguration` (type: `object`): Proxy settings passed to the underlying scrapers. Residential proxies recommended for reliable results. ## Actor input object example ```json { "searchQuery": "iphone 15", "maxItemsPerSource": 10, "timeoutPerSourceSecs": 120, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQuery": "iphone 15", "maxItemsPerSource": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/european-price-comparison").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 = { "searchQuery": "iphone 15", "maxItemsPerSource": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/european-price-comparison").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 '{ "searchQuery": "iphone 15", "maxItemsPerSource": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/european-price-comparison --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/european-price-comparison", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "European Price Comparison - Compare Prices Across EU Engines", "description": "Search 10 European price-comparison engines at once and compare prices for any product. Groups by EAN barcode, converts to EUR. No login or cookies required.", "version": "0.1", "x-build-id": "lpI03pYRpuumLFQjS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~european-price-comparison/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-european-price-comparison", "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/studio-amba~european-price-comparison/runs": { "post": { "operationId": "runs-sync-studio-amba-european-price-comparison", "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/studio-amba~european-price-comparison/run-sync": { "post": { "operationId": "run-sync-studio-amba-european-price-comparison", "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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Product to search for across all price engines (e.g., 'iphone 15', 'sony wh-1000xm5', 'dyson v15'). Use the brand and model for best matching." }, "countries": { "title": "Countries", "type": "array", "description": "Filter which countries to include. Leave empty to search all available engines (TR, PL, RO, AT, CZ, FR, BG, SE).", "items": { "type": "string" } }, "maxItemsPerSource": { "title": "Max Items Per Source", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of products to fetch from each price engine. Higher values give more matches but take longer and cost more.", "default": 10 }, "timeoutPerSourceSecs": { "title": "Timeout Per Source (seconds)", "minimum": 30, "maximum": 600, "type": "integer", "description": "Maximum time to wait for each underlying scraper to finish. Sources that take longer are skipped.", "default": 120 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings passed to the underlying scrapers. Residential proxies recommended for reliable results." } } }, "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 } } } } } } } } } } ```