# Kelkoo Scraper - European Price Comparison Data (`studio-amba/kelkoo-scraper`) Actor Scrape product prices and deals from Kelkoo, Europe's price comparison engine. Compare prices from thousands of French and European retailers across 22 countries. No login or cookies required. - **URL**: https://apify.com/studio-amba/kelkoo-scraper.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, NaN 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 ## Kelkoo Scraper -- European Price Comparison Data Scrape **product prices and deals from Kelkoo** -- Europe's leading price comparison engine with 40 million monthly visitors across 22 countries. Compare prices from thousands of French and European retailers, track deals, and extract structured product data. No login or cookies required. Run this Actor on [Apify](https://apify.com) to get structured price comparison data via API, schedule regular price monitoring, and integrate with your tools through webhooks, Zapier, or Make. ### How to scrape Kelkoo data Kelkoo is one of Europe's largest and oldest price comparison engines, operating since 1999. It aggregates product offers from thousands of retailers across France, the UK, Germany, Italy, Spain, the Netherlands, Belgium, and more. This Actor lets you extract that data at scale. #### Step-by-step guide 1. Go to the **Input** tab on this Actor's page 2. Enter a **search query** in the language of your target country (e.g., "ordinateur portable" for France, "laptop" for UK) 3. Select the **country** you want to search (France, UK, Germany, Italy, Spain, Netherlands, Belgium, Austria, Sweden, Norway, Denmark) 4. Set the **maximum number of results** you want (default: 100) 5. Click **Start** and wait for the Actor to finish 6. Download your data from the **Output** tab in JSON, CSV, Excel, or other formats #### Use via API You can also call this Actor programmatically via the Apify API: ```bash curl "https://api.apify.com/v2/acts/YOUR_USERNAME~kelkoo-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -X POST \ -d '{"searchQuery": "ordinateur portable", "country": "fr", "maxResults": 50}' \ -H 'Content-Type: application/json' ```` ### Why use Kelkoo Scraper? - **Multi-country coverage** -- Search across 11 European Kelkoo domains from a single Actor - **Price monitoring** -- Track prices for products across thousands of European retailers - **Market research** -- Compare pricing across France, UK, Germany, Italy, Spain, and more - **Competitive intelligence** -- See which merchants offer the best deals in each country - **E-commerce analytics** -- Analyze pricing trends and merchant competition at scale - **No login required** -- All data is publicly available, no account or cookies needed ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `searchQuery` | String | No | "ordinateur portable" | Search term in the target country's language | | `country` | String | No | "fr" | Country code: fr, uk, de, it, es, nl, be, at, se, no, dk | | `maxResults` | Integer | No | 100 | Maximum number of products to scrape (1-5000) | | `proxyConfiguration` | Object | No | FR residential | Proxy settings. Residential proxies matching the target country are recommended | #### Supported countries | Code | Country | Domain | Currency | |------|---------|--------|----------| | `fr` | France | kelkoo.fr | EUR | | `uk` | United Kingdom | kelkoo.co.uk | GBP | | `de` | Germany | kelkoo.de | EUR | | `it` | Italy | kelkoo.it | EUR | | `es` | Spain | kelkoo.es | EUR | | `nl` | Netherlands | kelkoo.nl | EUR | | `be` | Belgium | kelkoo.be | EUR | | `at` | Austria | kelkoo.at | EUR | | `se` | Sweden | kelkoo.se | SEK | | `no` | Norway | kelkoo.no | NOK | | `dk` | Denmark | kelkoo.dk | DKK | ### Output Each result contains structured product and pricing data: | Field | Type | Description | |-------|------|-------------| | `name` | String | Full product name | | `brand` | String | Product brand/manufacturer | | `price` | Number | Product price in local currency | | `currency` | String | Currency code (EUR, GBP, SEK, NOK, DKK) | | `merchant` | String | Retailer/shop name | | `merchantUrl` | String | URL to the product on the merchant's website | | `imageUrl` | String | Primary product image URL | | `productUrl` | String | Kelkoo product/comparison page URL | | `category` | String | Product category on Kelkoo | | `description` | String | Short product description | | `url` | String | Source search page URL | | `scrapedAt` | String | ISO 8601 timestamp of when the data was collected | ### Example output ```json { "name": "Apple MacBook Air M3 256 Go", "brand": "Apple", "price": 1099.00, "currency": "EUR", "merchant": "Amazon.fr", "merchantUrl": "https://www.amazon.fr/dp/B0CX23V2ZK", "imageUrl": "https://img.kelkoo.com/productimages/MacBookAir.jpg", "productUrl": "https://www.kelkoo.fr/offre/Apple-MacBook-Air-M3-256Go", "category": "Ordinateurs portables", "description": "Apple MacBook Air 13 pouces avec puce M3, 8 Go RAM, 256 Go SSD", "url": "https://www.kelkoo.fr/ctl/do/search?search=ordinateur+portable&cat=0", "scrapedAt": "2026-05-27T10:30:00.000Z" } ``` ### How much does it cost to scrape Kelkoo? This Actor uses browser-based scraping (Playwright) with residential proxies for reliable access. Estimated costs on Apify: | Volume | Estimated cost | Time | |--------|---------------|------| | 100 products | ~$0.15 | ~30 seconds | | 500 products | ~$0.60 | ~2 minutes | | 1,000 products | ~$1.20 | ~5 minutes | | 5,000 products | ~$5.00 | ~20 minutes | Costs may vary based on proxy usage and retry rates. The Apify Free plan includes $5/month of platform usage. ### Tips for best results - **Use residential proxies** -- Kelkoo blocks datacenter IPs. Residential proxies matching the target country are strongly recommended for reliable scraping - **Search in the local language** -- Use "ordinateur portable" for France, "Laptop" for Germany, "laptop" for UK/NL. Native-language queries return more results - **Start small** -- Test with `maxResults: 10` before running large scrapes - **Match proxy to country** -- Set `apifyProxyCountry` to match your selected country for best results - **Schedule regular runs** -- Set up scheduled runs for ongoing price monitoring across European markets ### Limitations - Kelkoo has anti-bot protection that requires residential proxies. Datacenter proxies will not work. - Results are limited by what Kelkoo returns for a given search query. Very niche queries may return fewer results. - Some country domains may have different page layouts; the Actor handles multiple DOM patterns but debug screenshots are saved if extraction fails. - Prices are shown as displayed on Kelkoo (TFC -- all fees included, except vehicle filing fees). ### FAQ and support **Is it legal to scrape Kelkoo?** This Actor extracts publicly available data from Kelkoo websites. Always review and comply with the website's Terms of Service before using. **Why am I getting no results?** Make sure you're using residential proxies matching the target country. Kelkoo actively blocks automated requests from datacenter IPs. Check the debug screenshots in the key-value store for more information. **Can I scrape multiple countries at once?** Run separate Actor tasks for each country. You can schedule them in parallel on Apify. **How often is Kelkoo data updated?** Kelkoo receives merchant feeds throughout the day, so prices are typically current within hours. For issues or feature requests, open an issue on this Actor's page or contact support. # Actor input Schema ## `searchQuery` (type: `string`): Search term in the language of the selected country (e.g. 'ordinateur portable' for France, 'laptop' for UK, 'Laptop' for Germany). ## `country` (type: `string`): Kelkoo country site to search. Determines the domain and default language. ## `maxResults` (type: `integer`): Maximum number of products to scrape. Each page typically contains 20-40 results. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies matching the selected country are strongly recommended — Kelkoo blocks datacenter IPs. ## Actor input object example ```json { "searchQuery": "ordinateur portable", "country": "fr", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } ``` # 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": "ordinateur portable", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/kelkoo-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 = { "searchQuery": "ordinateur portable", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/kelkoo-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 '{ "searchQuery": "ordinateur portable", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } }' | apify call studio-amba/kelkoo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/kelkoo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kelkoo Scraper - European Price Comparison Data", "description": "Scrape product prices and deals from Kelkoo, Europe's price comparison engine. Compare prices from thousands of French and European retailers across 22 countries. No login or cookies required.", "version": "0.1", "x-build-id": "5S6Days9gzgVPJtqz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~kelkoo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-kelkoo-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/studio-amba~kelkoo-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-kelkoo-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/studio-amba~kelkoo-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-kelkoo-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search term in the language of the selected country (e.g. 'ordinateur portable' for France, 'laptop' for UK, 'Laptop' for Germany)." }, "country": { "title": "Country", "enum": [ "fr", "uk", "de", "it", "es", "nl", "be", "at", "se", "no", "dk" ], "type": "string", "description": "Kelkoo country site to search. Determines the domain and default language.", "default": "fr" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of products to scrape. Each page typically contains 20-40 results.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies matching the selected country are strongly recommended — Kelkoo blocks datacenter IPs." } } }, "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 } } } } } } } } } } ```