# Kaufda Scraper - German Retail Offers and Brochures (`studio-amba/kaufda-scraper`) Actor

Scrape kaufda.de for weekly retail offers in Germany by product word or retailer. Get title, price, unit price, retailer, validity dates, category, image and brochure page.

- **URL**: https://apify.com/studio-amba/kaufda-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Kaufda Scraper

Pull the weekly retail offers of kaufda.de, the German leaflet and offer portal. The actor returns one row per offer with title, brand, retailer, price, original price, unit price, validity dates, category path, image and the brochure page it comes from.

You choose product words (for example Cola or Butter), retailers (for example REWE or Lidl), or both. The data suits price monitoring, promotion tracking, shelf price comparison and retail market research for Germany.

### How to scrape kaufda.de data

There are three ways to choose offers.

1. Product words. Fill `keywords` with German product words, for example `Cola`, `Butter`, `Waschmittel` or `Fernseher`. The actor reads the kaufda.de offer page of each word and returns the offers of all retailers. It also follows the narrower words that kaufda.de links on that page (for example Cola Light under Cola) until `maxResults` is reached.
2. Retailers. Fill `retailers` with names as listed on kaufda.de, for example `REWE`, `Lidl`, `Kaufland` or `Netto-Marken-Discount`. The actor reads the retailer page, then the product pages that kaufda.de links for that retailer.
3. Retailers and product words together. The actor returns the offers of those retailers for those words only.

Switch on `allRetailers` to read the full retailer list of kaufda.de and visit every retailer. Combine it with a high `maxResults` for a complete offer database.

Switch on `includeBrochures` to get one extra row per current brochure of each retailer, with validity dates, page count and cover image.

### Input

| Field | What it does |
|---|---|
| `keywords` | German product words as used on kaufda.de. |
| `retailers` | Retailer names as listed on kaufda.de/Geschaefte. |
| `allRetailers` | Visit every retailer in the kaufda.de store list. |
| `includeBrochures` | Add one row per current brochure of each retailer page. |
| `maxResults` | Maximum number of rows, offers and brochures together. |
| `proxyConfiguration` | Proxy used for the requests. Apify Proxy is the default. |

### What you get back

| Field | Content |
|---|---|
| `recordType` | `offer` or `brochure` |
| `offerId` | Offer ID on kaufda.de |
| `title`, `description`, `brand` | Product title, description (pack size, deposit) and brand |
| `retailer`, `retailerId` | Retailer name and kaufda.de retailer ID |
| `price`, `priceFormatted`, `currency` | Offer price as number, as shown, and currency |
| `originalPrice`, `originalPriceIsRecommended` | Price before the offer or recommended retail price, when shown |
| `unitPrice` | Price per base unit as shown, for example 1 kg = 21.96 |
| `priceCondition` | Condition attached to the price, for example je |
| `validFrom`, `validUntil` | Start and end of the offer |
| `categories`, `categoryPath` | Product categories, and the path from top level to the most specific category |
| `imageUrl` | Image of the offer |
| `brochureId`, `brochurePage` | The brochure the offer is printed in and its page |
| `source` | The search word or retailer page the row was found on |
| `url` | kaufda.de page the row was read from |
| `scrapedAt` | Time of the scrape |

Brochure rows carry `title`, `retailer`, `validFrom`, `validUntil`, `pageCount` and `coverImageUrl`.

### Example output

```json
{
  "recordType": "offer",
  "offerId": "1b938d6d-1ba2-492f-8b20-95f2667312f5",
  "title": "Crema e Gusto Classico",
  "description": "Gemahlen. Je 250 g",
  "brand": "LAVAZZA",
  "retailer": "Lidl",
  "retailerId": "DE-1013",
  "price": 5.49,
  "priceFormatted": "5,49 €",
  "currency": "EUR",
  "originalPrice": 5.99,
  "unitPrice": "1 kg = 21.96",
  "validFrom": "2026-11-14T23:00:00.000+0000",
  "validUntil": "2026-12-31T19:00:00.000+0000",
  "categoryPath": ["Lebensmittel und Getränke", "Produkte", "Getränke", "Heißgetränk", "Kaffee"],
  "brochureId": "236bb7db-ae39-400b-a9ac-947aaa3d821c",
  "brochurePage": 13,
  "url": "https://www.kaufda.de/Lidl/Sortiment/Lavazza"
}
```

### Use cases

- Price monitoring. Run the actor every week with the product words of your range and track the promotion price of each retailer.
- Promotion tracking. Check which brands are on offer at which retailer, for how long and at what discount against the original price.
- Shelf price comparison. Compare offer prices per kilo or per litre across retailers with `unitPrice`.
- Retail research. Read the brochure rows to see when each retailer starts and ends its leaflet.
- Category analysis. Use `categoryPath` to count offers per category and retailer.

### Cost and speed

The actor uses plain HTTP requests and no browser, so runs are cheap. kaufda.de asks for a crawl delay of 2 seconds, and the actor keeps to it. One page holds 8 to 20 offers, so 300 offers take about 25 pages and around one minute. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

### Notes and limits

- A product page on kaufda.de shows up to about 20 offers, even when the page says it has more. The actor widens the crawl through the narrower words and the retailer product pages that kaufda.de links, and removes duplicates by offer ID.
- Words have to match a word on kaufda.de. If a word returns nothing, the run log says so. Try the singular form or a nearby word.
- Offers are the national offers shown for the default location of kaufda.de. Store-level and city-level offers are not included.
- Only public pages are requested. The brochure viewer, the search and the internal API paths that robots.txt excludes are never requested.
- Prices are returned as published, in euros. Some offers have no price and return `null`.
- Offers change every week. Run the actor on a schedule to keep a price history.

### Frequently asked questions

#### Which retailers does kaufda.de cover?

Supermarkets, discounters, drugstores, DIY stores, electronics stores, furniture stores and more, for example REWE, Lidl, Kaufland, Aldi, Edeka, dm, MediaMarkt and Obi. Switch on `allRetailers` to read the full list.

#### How do I find the right product word?

Open kaufda.de, search for the product and look at the word in the address, for example `kaufda.de/Angebote/Cola`. Use that word.

#### How do I write a retailer name?

As in the address of the retailer page, for example `Lidl` or `Netto-Marken-Discount`. Spaces become hyphens automatically.

#### How many offers can I get in one run?

One page gives 8 to 20 offers. With several words, retailers or `allRetailers` you get thousands. `maxResults` limits the total.

#### Can I get the brochure pages as images?

The brochure rows return the cover image and the page count. Offers return the image of the single product and the page of the brochure they are printed on.

#### Does it work for Austria or Switzerland?

No. This actor covers kaufda.de for Germany.

#### How often can I run it?

As often as you like. Offers change weekly, so a weekly schedule in Apify is enough for most price monitoring.

### Related scrapers

- Lidl Scraper for the Lidl product catalogue
- Rewe Scraper for the REWE product catalogue

# Actor input Schema

## `keywords` (type: `array`):

Product words in German as used on kaufda.de, for example Cola, Butter, Waschmittel or Fernseher. Without retailers, you get the offers of all retailers for each word. With retailers, you get the offers of those retailers for each word.

## `retailers` (type: `array`):

Retailer names as listed on kaufda.de/Geschaefte, for example REWE, Lidl, Kaufland or Netto-Marken-Discount. Without product words, the actor reads the retailer page and its product pages.

## `allRetailers` (type: `boolean`):

Read the retailer list at kaufda.de/Geschaefte and visit every retailer page. Combine with a high Max results to build a full offer database.

## `includeBrochures` (type: `boolean`):

Also return one row per current brochure (leaflet) of each retailer, with validity dates and page count. Brochure rows come from retailer pages.

## `maxResults` (type: `integer`):

Maximum number of rows to return, offers and brochures together. One page holds 8 to 20 offers.

## `proxyConfiguration` (type: `object`):

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "keywords": [
    "Cola"
  ],
  "allRetailers": false,
  "includeBrochures": false,
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "Cola"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/kaufda-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["Cola"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/kaufda-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "Cola"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/kaufda-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/kaufda-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TL2e6QswPRp1nAmD0/builds/9UNmX0c60aEqYipSC/openapi.json
