# Kaufland Scraper — German Marketplace Products & Prices (`studio-amba/kaufland-de-scraper`) Actor Scrape products from the Kaufland.de marketplace: names, prices, sellers, brands, EAN codes, ratings, images and categories. Search by keyword, category or product URLs. No login, no cookies. - **URL**: https://apify.com/studio-amba/kaufland-de-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, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 result scrapeds 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Kaufland.de Scraper Scrape product data from the [Kaufland.de](https://www.kaufland.de) marketplace — Germany's Schwarz Group online marketplace (formerly real.de) with millions of products from Kaufland direct sales and third-party sellers. Search by keyword, pull a whole category, or hand it a list of product URLs. Get back clean, structured records with prices, sellers, brands, EAN codes, ratings, images and categories. No login, no cookies. ### Why use this actor? Kaufland is one of the largest online marketplaces in Germany, and its catalogue changes constantly across thousands of independent sellers. This actor turns any keyword or category into a structured product feed you can drop into a spreadsheet, a pricing tool, or a database. Typical users: brands tracking how their products are priced and sold across marketplace sellers, retailers doing competitive price monitoring, resellers sourcing products, and analysts building assortment or market-share reports. ### What you get - **Real marketplace prices** in EUR as numbers (not strings), plus price per unit (e.g. `18.78 EUR/1kg`) and strike-through / RRP where a product is on sale. - **Seller name** for every item — the marketplace seller, or `Kaufland` for direct sales. - **Brand, EAN, category, ratings and review counts** — high field coverage because the data comes straight from Kaufland's own product API, not scraped HTML. - **All product images** in full resolution. - **No login and no cookies** — nothing to configure beyond a keyword. ### How to scrape Kaufland data 1. Add the actor to your Apify account. 2. Enter a **Search Query** (a German keyword like `kaffee`, `laptop`, `kopfhörer`), or a **Category ID**, or paste **Product URLs**. 3. Set **Max Results** to how many products you want. 4. Provide a **Bright Data API key** (see below) or set the `BRIGHT_DATA_API_KEY` environment variable. 5. Run it. Download the results as JSON, CSV, Excel or feed them to an API. Kaufland.de sits behind Cloudflare and DataDome, so the actor routes its requests through the [Bright Data](https://brightdata.com) Web Unlocker, which solves the bot challenge and returns the data. You need a Bright Data account with a Web Unlocker zone; the key goes in the `brightDataApiKey` input (kept secret) or the `BRIGHT_DATA_API_KEY` environment variable. ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQuery` | String | No | Keyword to search the marketplace (default: `kaffee`). Products are discovered by keyword and enriched with full data. | | `categoryId` | Integer | No | A numeric Kaufland category id to pull instead of a keyword (e.g. `5921` = Kaffeepulver). Category ids appear in the `category` data of any scraped product. | | `productUrls` | Array | No | One or more `https://www.kaufland.de/product//` URLs to scrape directly. | | `maxResults` | Integer | No | Maximum number of products to return (default: 100). | | `brightDataApiKey` | String | Yes | Bright Data Web Unlocker API key. Falls back to the `BRIGHT_DATA_API_KEY` environment variable. | | `proxyConfiguration` | Object | No | Apify proxy settings for auxiliary requests. | Leave everything empty and the actor runs a default `kaffee` search, so an empty input `{}` still returns data. ### Output Each result contains: | Field | Type | Example | |-------|------|---------| | `name` | String | `"EILLES KAFFEE Gourmet, 500g Bohnen"` | | `brand` | String | `"Eilles"` | | `price` | Number | `9.39` | | `currency` | String | `"EUR"` | | `originalPrice` | Number | `12.99` (null if not on sale) | | `pricePerUnit` | String | `"18.78 EUR/1kg"` | | `discount` | String | `"-15%"` (null if not on sale) | | `ean` | String | `"4006581020020"` | | `sku` | String | `"385382997410"` (Kaufland offer id) | | `productId` | String | `"318524735"` | | `seller` | String | `"GOURVITA"` | | `inStock` | Boolean | `true` | | `rating` | Number | `4.86` | | `reviewCount` | Integer | `7` | | `url` | String | `"https://www.kaufland.de/product/318524735/"` | | `imageUrl` | String | Primary product image URL | | `imageUrls` | Array | All product image URLs | | `category` | String | `"Kaffeebohnen"` | | `scrapedAt` | String | ISO 8601 timestamp | ### Example output ```json { "name": "EILLES KAFFEE Gourmet, 500g Bohnen", "brand": "Eilles", "price": 9.39, "currency": "EUR", "pricePerUnit": "18.78 EUR/1kg", "ean": "4006581020020", "sku": "385382997410", "productId": "318524735", "seller": "GOURVITA", "inStock": true, "rating": 4.86, "reviewCount": 7, "url": "https://www.kaufland.de/product/318524735/", "imageUrl": "https://media.cdn.kaufland.de/product-images/original/3609ab1eeea1bf63f751d006259a4f5c.jpg", "imageUrls": [ "https://media.cdn.kaufland.de/product-images/original/3609ab1eeea1bf63f751d006259a4f5c.jpg", "https://media.cdn.kaufland.de/product-images/original/176ce9153f7103bac94de80962744ab0.jpg" ], "category": "Kaffeebohnen", "scrapedAt": "2026-07-06T19:36:04.579Z" } ```` ### How it works Kaufland's own keyword search endpoints are blocked to automated access, so the actor works entirely from Kaufland's public, robots-allowed product API: 1. **Enumeration.** A keyword search finds matching product ids across the marketplace; a category id or a list of product URLs skips straight to known products. 2. **Data.** Product ids are sent in batches to Kaufland's product-tiles API, which returns clean JSON — prices, sellers, brands, EAN codes, ratings and images — with very high field coverage. Because the data is batched and comes from the API rather than parsed HTML, runs are fast and cheap and the output is consistent. ### Cost estimate Enumeration is cheap (about one request per ten products) and product data is fetched in batches of up to 50, so a run of 1,000 products is roughly a few hundred requests. Actual cost depends on your Apify plan and your Bright Data Web Unlocker usage. ### Limitations - Requires a Bright Data Web Unlocker key — Kaufland.de is behind Cloudflare and DataDome and cannot be reached without it. - Keyword search relevance and coverage depend on what is indexed publicly, so a keyword run returns the most relevant products rather than a guaranteed exhaustive list. Use `categoryId` for category-scoped pulls. - `originalPrice` and `discount` are only present when a product is actually on sale. - Data is scraped from the public marketplace and may change without notice. Respect the website's terms of service and use responsibly. ### Related scrapers Other German e-commerce scrapers from the same catalogue: - [Otto Scraper](https://apify.com/studio-amba/otto-scraper) — otto.de products and prices - [Idealo Scraper](https://apify.com/studio-amba/idealo-scraper) — idealo.de price comparison - [Alternate Scraper](https://apify.com/studio-amba/alternate-scraper) — alternate.de electronics - [Baby-Walz Scraper](https://apify.com/studio-amba/baby-walz-scraper) — baby-walz.de baby products ### Need this data on a schedule, or a custom version? We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API — maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed. See [studioamba.dev/services](https://studioamba.dev/services/) or email for a free data sample. We maintain 300+ European web scrapers and answer within one business day. # Actor input Schema ## `searchQuery` (type: `string`): Keyword to search the Kaufland.de marketplace (e.g., 'kaffee', 'laptop', 'kopfhörer'). Products are discovered by keyword and enriched with the full product data. ## `categoryId` (type: `integer`): Optional. A numeric Kaufland category id to pull products for instead of a keyword search (e.g., 5921 = Kaffeepulver). Category ids appear in the 'category.id' field of any scraped product. ## `productUrls` (type: `array`): Optional. One or more Kaufland product URLs to scrape directly (https://www.kaufland.de/product/333223807/). ## `maxResults` (type: `integer`): Maximum number of products to return. ## `brightDataApiKey` (type: `string`): Bright Data API key for the Web Unlocker zone. Required — Kaufland.de is behind Cloudflare and DataDome and cannot be reached without it. Falls back to the BRIGHT\_DATA\_API\_KEY environment variable. ## `proxyConfiguration` (type: `object`): Proxy settings. Kaufland access itself goes through the Bright Data Web Unlocker; this proxy is used for any auxiliary requests. ## Actor input object example ```json { "searchQuery": "kaffee", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } ``` # 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": "kaffee", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/kaufland-de-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": "kaffee", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "DE", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/kaufland-de-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": "kaffee", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }' | apify call studio-amba/kaufland-de-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/kaufland-de-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kaufland Scraper — German Marketplace Products & Prices", "description": "Scrape products from the Kaufland.de marketplace: names, prices, sellers, brands, EAN codes, ratings, images and categories. Search by keyword, category or product URLs. No login, no cookies.", "version": "0.1", "x-build-id": "LHuoIERNFD8fPBdjv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~kaufland-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-kaufland-de-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~kaufland-de-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-kaufland-de-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~kaufland-de-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-kaufland-de-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": "Keyword to search the Kaufland.de marketplace (e.g., 'kaffee', 'laptop', 'kopfhörer'). Products are discovered by keyword and enriched with the full product data." }, "categoryId": { "title": "Category ID", "type": "integer", "description": "Optional. A numeric Kaufland category id to pull products for instead of a keyword search (e.g., 5921 = Kaffeepulver). Category ids appear in the 'category.id' field of any scraped product." }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Optional. One or more Kaufland product URLs to scrape directly (https://www.kaufland.de/product/333223807/).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "brightDataApiKey": { "title": "Bright Data API Key", "type": "string", "description": "Bright Data API key for the Web Unlocker zone. Required — Kaufland.de is behind Cloudflare and DataDome and cannot be reached without it. Falls back to the BRIGHT_DATA_API_KEY environment variable." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Kaufland access itself goes through the Bright Data Web Unlocker; this proxy is used for any auxiliary requests." } } }, "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 } } } } } } } } } } ```