# Marktguru & Gazetki Leaflet Offers Scraper (DE, AT, PL) (`trev0n/marktguru-gazetki-scraper`) Actor

Weekly supermarket leaflet offers (Prospekte, gazetki) from marktguru.de, marktguru.at and gazetkowo.pl: Lidl, Aldi, REWE, Billa, Biedronka and 300+ chains. Price, regular price, discount, unit price, brand, validity, leaflet page, by postal code.

- **URL**: https://apify.com/trev0n/marktguru-gazetki-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Features:** Limited permissions
- **Stats:** 11 total users, 9 monthly users, 99.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 offer or leaflets

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/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

## 🛒 Marktguru & Gazetki Leaflet Offers Scraper (DE, AT, PL)

🎯 **Every weekly supermarket deal from Germany, Austria and Poland — Prospekte and gazetki promocyjne turned into a clean price list.**

Collect the offers printed in this week's leaflets of Lidl, Aldi, REWE, EDEKA, Kaufland, Penny, Netto, Billa, Spar, Hofer, Biedronka, Dino, Auchan, Carrefour and 300+ other chains from **marktguru.de**, **marktguru.at** and **gazetkowo.pl**. Every offer comes with retailer, product, brand, offer price, regular price, discount, unit price, validity dates, the leaflet and page it is printed on, a product image and its category — localised to the postal code you choose.

### 🚀 What Does It Do?

This scraper automatically reads the current and upcoming leaflet offers and delivers **structured, ready-to-use data** — one row per offer, the same columns for all three countries. No manual flipping through leaflets — just pick a country, a product or a chain and hit Start.

💡 **Two modes of operation:**

1. **🔍 Discovery Mode** — search for a product ("Butter", "Kaffee", "kawa"), pick chains ("Lidl", "Biedronka"), brands ("Milka") or take the whole market at once.
2. **📋 Direct URL Mode** — paste links from marktguru or gazetkowo: a retailer page, a brand page, a search, a single offer or a whole leaflet.

### 👥 Who Is This For?

| 🏢 Use Case                                | 💬 How It Helps                                                                                 |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| 📊 **Price-intelligence teams**            | Track competitors' promo prices, discount depth and promo frequency week by week                |
| 🏭 **FMCG brands & category managers**     | See every retailer that is promoting your brand (and your competitors') and at what price       |
| 📈 **Market researchers & analysts**       | Build datasets of promotional pricing across DE, AT and PL with unit prices for fair comparison |
| 🛍️ **Deal & coupon apps**                  | Feed your app or newsletter with fresh leaflet deals every week                                 |
| 🤖 **Shopping-list & meal-planning tools** | Match recipes or shopping lists with the cheapest current offers near the user                  |
| 📰 **Media & bloggers**                    | Spot the best weekly deals and price drops for articles and social posts                        |

### ✨ Features

- 🌍 **Three markets in one tool** — Germany (marktguru.de), Austria (marktguru.at) and Poland (gazetkowo.pl) with one shared output format
- 🏪 **300+ retail chains** — supermarkets, discounters, drugstores, DIY, furniture and electronics stores
- 🔍 **Product search** — find every leaflet offer for "Butter", "Bier", "kawa" or "pieluchy" across all chains
- 🏷️ **Brand tracking** — every offer of Milka, Coca-Cola, Jacobs… across every chain (DE/AT)
- 📍 **Regional offers** — choose a postal code; offers differ between Berlin and Munich, Vienna and Graz
- 💸 **Prices that compare** — offer price, regular price, discount % and unit price (e.g. 4.97 EUR/kg)
- 📰 **Leaflet & page** — every offer is linked to the leaflet and page number it is printed on, plus a product image
- 🗂️ **Leaflet export** — optionally get the leaflets themselves: title, validity, page count, cover and every page image
- 📅 **Validity filter** — valid now, upcoming, or both
- 🎛️ **Smart Filters** — minimum discount, maximum price, chains, brands
- 🔁 **Only new offers since last run** — schedule it weekly and receive only new or changed deals, with alerts to Telegram, Discord, Slack or a webhook
- ⚡ **Fast & Scalable** — a single chain in seconds, the whole Polish market (~16 000 offers) in a few minutes
- 🧹 **Deduplication** — every offer appears once, even when several searches hit it
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option                                    | What It Does                                                              |
| ----------------------------------------- | ------------------------------------------------------------------------- |
| 🌍 **Country**                            | Germany, Austria or Poland                                                |
| 🔍 **Products to search**                 | Keywords searched across every leaflet                                    |
| 🏪 **Retailers**                          | Chains to scrape — alone (all their offers) or to narrow a product search |
| 🏷️ **Brands**                             | Every offer of a brand across all chains                                  |
| 🛒 **All retailers**                      | The whole market for the chosen postal code                               |
| 📍 **Postal code**                        | Where the offers should be valid                                          |
| 📦 **What to output**                     | Offers, leaflets, or both                                                 |
| 🖼️ **Every leaflet page image**           | Add the image of every page to leaflet records                            |
| 🧾 **Category for retailer offers**       | Add the product category to chain and brand lists (Germany/Austria)       |
| 📅 **Validity**                           | Valid now, upcoming, both, or everything listed                           |
| 💸 **Minimum discount %**                 | Only real deals                                                           |
| 💶 **Maximum price**                      | Only offers under a price                                                 |
| 🔁 **Only new offers since last run**     | Monitoring mode with memory and alerts                                    |
| 🔔 **Alerts**                             | Webhook, Telegram, Discord or Slack message after each run                |
| 🗜️ **Compact output / drop empty fields** | Slimmer rows for spreadsheets                                             |
| 🔢 **Max Results**                        | Control how many items to extract per run                                 |
| 🔗 **Direct URLs**                        | Optionally provide specific URLs to scrape                                |

### 🧪 Example Inputs

🇩🇪 **Butter offers in Munich, discounted at least 20%:**

```json
{ "country": "DE", "searchTerms": ["Butter"], "postalCode": "80331", "minDiscountPercent": 20 }
```

🇦🇹 **Every BILLA and SPAR offer in Vienna, plus their leaflets:**

```json
{
    "country": "AT",
    "retailers": ["Billa", "Spar"],
    "postalCode": "1010",
    "outputType": "offersAndLeaflets",
    "maxItems": 0
}
```

🇵🇱 **Coffee at Biedronka and Lidl:**

```json
{ "country": "PL", "searchTerms": ["kawa"], "retailers": ["Biedronka", "Lidl"] }
```

🇵🇱 **The whole Polish market, weekly, only new offers:**

```json
{ "country": "PL", "allRetailers": true, "maxItems": 0, "incrementalMode": true }
```

🇩🇪 **Brand monitoring with a Telegram alert:**

```json
{
    "country": "DE",
    "brands": ["Milka", "Coca-Cola"],
    "incrementalMode": true,
    "telegramBotToken": "…",
    "telegramChatId": "…"
}
```

🔗 **Links:**

```json
{
    "startUrls": [
        { "url": "https://www.marktguru.de/r/lidl" },
        { "url": "https://www.marktguru.at/b/manner" },
        { "url": "https://www.gazetkowo.pl/sieci-handlowe/dino" },
        { "url": "https://www.gazetkowo.pl/gazetki-promocyjne/spozywcze/biedronka/gazetka-22" }
    ]
}
```

### 📦 What You Get (Output Fields)

Every offer includes:

#### Offer

| Field       | Example                             |
| ----------- | ----------------------------------- |
| recordType  | `offer`                             |
| source      | `marktguru.de`                      |
| country     | `DE`                                |
| offerId     | `25396767`                          |
| retailer    | `Lidl`                              |
| title       | `mit Butter XXL`                    |
| brand       | `Rama`                              |
| description | `Versch. Sorten. Gekühlt. Je 400 g` |
| category    | `Butter`                            |
| industry    | `Discounter`                        |
| offerType   | `standard`                          |

#### Price

| Field               | Example       |
| ------------------- | ------------- |
| price               | `1.99`        |
| regularPrice        | `2.79`        |
| discountPercent     | `29`          |
| currency            | `EUR`         |
| unitPrice           | `4.97`        |
| unit                | `kg`          |
| unitPriceText       | `4.97 EUR/kg` |
| quantity            | `1`           |
| requiresLoyaltyCard | `false`       |

#### Validity & leaflet

| Field          | Example                                             |
| -------------- | --------------------------------------------------- |
| validFrom      | `2026-10-28T23:00:00.000Z`                          |
| validTo        | `2026-10-31T22:59:00.000Z`                          |
| validityStatus | `upcoming`                                          |
| leafletId      | `6411787`                                           |
| leafletPage    | `66`                                                |
| leafletUrl     | `https://www.marktguru.de/leaflets/6411787/page/65` |

#### Links & context

| Field      | Example                                                                       |
| ---------- | ----------------------------------------------------------------------------- |
| offerUrl   | `https://www.marktguru.de/offers/25396767`                                    |
| imageUrl   | `https://cdn.marktguru.de/api/v1/offers/25396767/images/default/0/large.webp` |
| storeName  | `null`                                                                        |
| postalCode | `10115`                                                                       |
| matchedBy  | `search:Butter`                                                               |
| scrapedAt  | `2026-10-20T12:00:00.000Z`                                                    |

#### Leaflet records (when leaflets are requested)

| Field         | Example                                                                              |
| ------------- | ------------------------------------------------------------------------------------ |
| leafletTitle  | `Pranie i prasowanie do -55%`                                                        |
| pageCount     | `10`                                                                                 |
| offerCount    | `601`                                                                                |
| coverImageUrl | `https://cdn1.promotons.com/resize?fileName=production/gazetkowo/newspapers/…-0.png` |
| pageImageUrls | `["…-0.png", "…-1.png"]`                                                             |

### 📊 Example Output

```json
{
    "recordType": "offer",
    "source": "marktguru.at",
    "country": "AT",
    "offerId": "3445196",
    "retailer": "BILLA",
    "retailerSlug": "billa",
    "title": "Schafkäse",
    "brand": "Salakis",
    "description": "div. Sorten 180 g",
    "category": null,
    "industry": "Supermarkt",
    "price": 2.52,
    "regularPrice": 3.79,
    "discountPercent": 34,
    "currency": "EUR",
    "unitPrice": 14,
    "unit": "kg",
    "unitPriceText": "14.00 EUR/kg",
    "quantity": 1,
    "requiresLoyaltyCard": null,
    "validFrom": "2026-10-14T22:00:00.000Z",
    "validTo": "2026-10-21T21:59:00.000Z",
    "validityStatus": "current",
    "leafletId": "82421",
    "leafletFlightId": 45710,
    "leafletPage": 10,
    "leafletUrl": "https://www.marktguru.at/leaflets/82421/page/9",
    "offerUrl": "https://www.marktguru.at/offers/3445196",
    "imageUrl": "https://cdn.marktguru.at/api/v1/offers/3445196/images/default/0/large.webp",
    "storeName": null,
    "postalCode": "8010",
    "offerType": "standard",
    "matchedBy": "retailer:billa",
    "contentHash": "5f0e2b7c9a1d4e33",
    "scrapedAt": "2026-10-20T16:52:11.204Z"
}
```

🇵🇱 A Polish offer has the same shape:

```json
{
    "recordType": "offer",
    "source": "gazetkowo.pl",
    "country": "PL",
    "offerId": "01a14f71-c7bb-7009-89d3-123a31ddd4d4",
    "retailer": "Biedronka",
    "title": "Kawa ziarnista Eduscho Crema",
    "brand": null,
    "category": "Kawa",
    "industry": "Spożywcze",
    "price": 49.99,
    "regularPrice": 69.99,
    "discountPercent": 29,
    "currency": "PLN",
    "validFrom": "2026-10-19T00:00:00+02:00",
    "validTo": "2026-10-24T23:59:59+02:00",
    "validityStatus": "current",
    "leafletId": "01a14ee6-b3b3-722b-91c3-6d9d947183a5",
    "leafletPage": 3,
    "leafletUrl": "https://www.gazetkowo.pl/gazetki-promocyjne/spozywcze/biedronka/01a14ee6-b3b3-722b-91c3-6d9d947183a5",
    "postalCode": "00-001",
    "scrapedAt": "2026-10-20T16:55:02.871Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **4 ready-made table views** to quickly browse your results:

| View                       | What It Shows                                                                   |
| -------------------------- | ------------------------------------------------------------------------------- |
| 📊 **Overview**            | Image, retailer, product, brand, price, regular price, discount, validity, link |
| 💸 **Deals & unit prices** | Discount, unit price, loyalty-card offers and the leaflet page                  |
| 📰 **Leaflets**            | Cover, retailer, title, validity, page and offer count                          |
| 📋 **Full Details**        | Every single field — the complete dataset                                       |

### ❓ FAQ

**🤔 Which chains are covered?**
Everything marktguru and gazetkowo show: in Germany Lidl, Aldi Nord/Süd, REWE, EDEKA, Kaufland, Penny, Netto, Norma, Rossmann, OBI, toom and many more; in Austria Billa, Billa Plus, Spar, Hofer, Penny and more; in Poland Biedronka, Lidl, Kaufland, Dino, Auchan, Carrefour, Intermarché, Netto, Stokrotka, Żabka, Rossmann, Hebe, Castorama and 240+ more.

**🤔 Why do I get different offers for different postal codes?**
Many chains run regional leaflets. In Germany and Austria the postal code decides which leaflets and offers you see — Berlin gets Aldi Nord, Munich gets Aldi Süd.

**🤔 Why is the regular price sometimes empty?**
Leaflets do not always print a "was" price. When it is missing, the discount is empty too — use the unit price to compare offers fairly.

**🤔 Can I get only the deals that are new this week?**
Yes — switch on "Only new offers since last run". The first run remembers everything; later runs output only new, changed or returning offers, and can send you an alert.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks.

**🤔 Does it work with proxies?**
Yes — it works without a proxy, and Apify Proxy can be switched on in the input if you ever need it.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (product categories, store-level prices, loyalty-card-only deals, specific regions)
- 📊 Extra data fields or custom output formats
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication
- 🌐 Scraping from other leaflet platforms alongside marktguru and gazetkowo (more countries, more chains)

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from marktguru.de, marktguru.at and gazetkowo.pl — the same offers anyone can browse on these sites. It does not log in, access private data or bypass any protection. Please use the data responsibly and in compliance with applicable laws and the platforms' terms of service.

# Actor input Schema

## `country` (type: `string`):

Which market to scrape: Germany (marktguru.de), Austria (marktguru.at) or Poland (gazetkowo.pl). Links in Start URLs are always scraped from their own site, whatever this is set to.

## `searchTerms` (type: `array`):

Product keywords searched across every leaflet, e.g. "Butter", "Kaffee", "kawa", "piwo". Combine with Retailers to search only those chains.

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

Chain names, e.g. "Lidl", "REWE", "Aldi Süd", "Billa", "Biedronka", "Kaufland". Alone: every current offer of each chain. With products to search: only that chain's hits. "Aldi" matches both Aldi Nord and Aldi Süd.

## `brands` (type: `array`):

Brand names, e.g. "Milka", "Coca-Cola", "Jacobs". Germany/Austria: every offer of the brand across all chains. Poland: the brand is searched as a keyword.

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

Scrape every current offer of every chain for the postal code (Germany/Austria) or the whole Polish market (~16 000 offers). Set Max items to 0 for everything.

## `postalCode` (type: `string`):

Offers are regional. Germany: 5 digits (default 10115 Berlin). Austria: 4 digits (default 1010 Vienna). Poland: 00-001 format (default Warsaw).

## `startUrls` (type: `array`):

Optional links: marktguru retailer (/r/lidl), brand (/b/milka), search (/search/butter), offer (/offers/…) or leaflet (/leaflets/…); gazetkowo retailer (/sieci-handlowe/biedronka), search (/wyszukaj/kawa) or leaflet (/gazetki-promocyjne/…).

## `outputType` (type: `string`):

Offers only, leaflets only (title, validity, page count, cover and page images), or both.

## `includePageImages` (type: `boolean`):

Leaflet records also list the image URL of every page (not only the cover).

## `includeOfferDetails` (type: `boolean`):

Germany/Austria retailer and brand lists come without a product category; this reads each offer once more to add it. Slower. Search results and Polish offers already have their category.

## `validity` (type: `string`):

Keep offers valid now, starting later, both, or every offer the site still lists.

## `minDiscountPercent` (type: `integer`):

Keep only offers discounted at least this much against the regular price (0 = no filter). Offers without a regular price are dropped when this is set.

## `maxPrice` (type: `integer`):

Keep only offers at or under this price in EUR / PLN (0 = no filter).

## `maxItems` (type: `integer`):

Maximum records per run (0 = unlimited).

## `maxConcurrency` (type: `integer`):

Parallel requests.

## `compact` (type: `boolean`):

Only the key fields (retailer, title, brand, prices, discount, validity, link).

## `excludeEmptyFields` (type: `boolean`):

Remove null and empty fields from every record.

## `incrementalMode` (type: `boolean`):

Remember what earlier runs returned and output only new, changed or reappeared offers. Ideal for scheduled runs.

## `stateKey` (type: `string`):

Name of the memory for incremental mode. Leave empty to derive it from the search settings.

## `emitUnchanged` (type: `boolean`):

In incremental mode, also output offers seen before (tagged UNCHANGED).

## `emitExpired` (type: `boolean`):

In incremental mode, also output offers that disappeared since the last run (tagged EXPIRED).

## `webhookUrl` (type: `string`):

POST a JSON summary of new offers here after each run.

## `telegramBotToken` (type: `string`):

Send new offers to Telegram (together with chat ID).

## `telegramChatId` (type: `string`):

Telegram chat that receives the alerts.

## `discordWebhookUrl` (type: `string`):

Send new offers to a Discord channel.

## `slackWebhookUrl` (type: `string`):

Send new offers to a Slack channel.

## `notifyOnlyChanges` (type: `boolean`):

Skip the alert when a run found nothing new.

## `notificationLimit` (type: `integer`):

How many offers an alert lists before "…and N more".

## `includeRunSummary` (type: `boolean`):

Add the run's counts to the webhook payload.

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

Not needed — the sites answer without a proxy. Turn on Apify Proxy only if you see blocked requests.

## Actor input object example

```json
{
  "country": "DE",
  "searchTerms": [
    "Butter"
  ],
  "allRetailers": false,
  "outputType": "offers",
  "includePageImages": false,
  "includeOfferDetails": false,
  "validity": "currentAndUpcoming",
  "minDiscountPercent": 0,
  "maxPrice": 0,
  "maxItems": 200,
  "maxConcurrency": 6,
  "compact": false,
  "excludeEmptyFields": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "notifyOnlyChanges": true,
  "notificationLimit": 10,
  "includeRunSummary": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `details` (type: `string`):

No description

## `runSummary` (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 = {
    "searchTerms": [
        "Butter"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/marktguru-gazetki-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 = { "searchTerms": ["Butter"] }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/marktguru-gazetki-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 '{
  "searchTerms": [
    "Butter"
  ]
}' |
apify call trev0n/marktguru-gazetki-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/marktguru-gazetki-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/xdyTSP69dx2oGiCUD/builds/qhbCgX8R1hAwqNogY/openapi.json
