# Delhaize Scraper — Belgian Supermarket Products & Prices (`studio-amba/delhaize-scraper`) Actor

Scrape products, prices, unit prices, promotions and Nutri-Score from Delhaize.be. Search by keyword or browse by category. No login or cookies required.

- **URL**: https://apify.com/studio-amba/delhaize-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 7 total users, 2 monthly users, 100.0% runs succeeded, 1 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/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

## Delhaize Scraper — Belgian Supermarket Products & Prices

Scrape the full product catalog of [Delhaize.be](https://www.delhaize.be), one of Belgium's largest supermarkets (part of Ahold Delhaize). Get product names, prices, unit prices, promotions, brands, Nutri-Score and stock status as clean structured JSON. No login, no cookies, no browser automation.

Search by keyword or browse a whole category. Built for price monitoring, competitor analysis, assortment tracking and market research.

### What it does

This actor reads Delhaize's own product API directly, so you get the same prices and data a shopper sees on the website — without rendering pages in a browser. It's fast, stable and cheap to run.

- **Keyword search** — pass a search term (`melk`, `koffie`, `pasta`) and get matching products.
- **Category browse** — pass a Delhaize category code (e.g. `v2DAI` for dairy) to pull a whole department.
- **Dutch or French** — choose the language for product names.
- **Promotions** — discounted prices and promo flags are included.

### Output

Each product is one record:

```json
{
  "name": "Delhaize Halfvolle melk",
  "brand": "Delhaize",
  "sku": "S2018032200041700099",
  "price": 1.09,
  "currency": "EUR",
  "unit": "1 l",
  "unitPrice": "1,09 €/l",
  "promotionPrice": null,
  "nutriScore": "B",
  "category": "Zuivel, kaas en plantaardige alternatieven",
  "url": "https://www.delhaize.be/nl/shop/.../p/S2018032200041700099",
  "imageUrl": "https://www.delhaize.be/medias/sys_master/products/.../product.jpg",
  "inStock": true,
  "scrapedAt": "2026-06-24T09:20:00.000Z"
}
```

#### Fields

| Field | Description |
|-------|-------------|
| `name` | Product name |
| `brand` | Manufacturer / brand name |
| `sku` | Delhaize internal product code (Hybris ID) |
| `price` | Current price as a number |
| `currency` | Always `EUR` |
| `unit` | Pack size label (e.g. `1 l`, `6 st`) |
| `unitPrice` | Price per unit (e.g. `1,09 €/l`) |
| `promotionPrice` | Promo price when the product is on offer, otherwise `null` |
| `nutriScore` | Nutri-Score letter (A–E) when available |
| `category` | Top-level category name |
| `url` | Link to the product page |
| `imageUrl` | Product image URL |
| `inStock` | Whether the product is available |
| `scrapedAt` | ISO timestamp of the scrape |

> Note: Delhaize does not expose an EAN/barcode for its products — `sku` is the internal Delhaize product code, not a retail barcode.

### How to scrape Delhaize data

1. Open the actor and set your **Search Query** (for example `melk`) — or leave it empty and set a **Category Code** to browse a department.
2. Set **Max Results** to the number of products you want.
3. Pick the **Language** (`nl` or `fr`).
4. Keep the default **Proxy Configuration** (Belgian proxy is recommended for correct prices).
5. Click **Start**. When the run finishes, download the dataset as JSON, CSV or Excel, or pull it from the API.

#### Input example

```json
{
  "searchQuery": "koffie",
  "maxResults": 100,
  "language": "nl",
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "BE" }
}
```

#### Browsing a category

```json
{
  "category": "v2DAI",
  "maxResults": 500,
  "language": "nl",
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "BE" }
}
```

Category codes are visible in the Delhaize category URLs (`/nl/shop/.../c/v2DAI`). Common top-level codes include `v2DAI` (dairy), `v2FRU` (fruit & veg), `v2MEA` (meat), `v2BAK` (bakery), `v2DRI` (drinks).

### Common use cases

- **Price monitoring** — track Delhaize prices over time and compare against other supermarkets.
- **Promotion tracking** — capture discounted items and offer prices.
- **Assortment analysis** — see which products and brands a category carries.
- **Market research** — build a dataset of Belgian grocery prices for analysis.

### How much does it cost?

This actor is billed $0.02 per run plus $0.002 per result:

- **100 products**: ~$0.22
- **1,000 products**: ~$2.02

Your run's usage cost only settles after the run reports SUCCEEDED — reading a mid-run dataset understates the eventual cost.

### Tips

- For a full category, set a higher **Max Results** and use the **Category Code** input.
- Prices can vary slightly over time; run the actor on a schedule to keep your data fresh.
- The actor uses Delhaize's own data API. If Delhaize ships a major site update, the internal query identifier can change and a run may fail with a clear message — set the advanced **Persisted Query Hash** input to recover, or report it and it will be updated.

### FAQ

**Does this need my Delhaize login?**
No. The actor only reads public catalog data. No account, password or cookies are required.

**Can I get the barcode (EAN)?**
No. Delhaize does not publish an EAN/GTIN for its products. The `sku` field is Delhaize's own internal code.

**Which languages are supported?**
Dutch (`nl`) and French (`fr`), matching the two language versions of the Delhaize site.

**Is this legal?**
The actor collects publicly available product information. You are responsible for using the data in line with Delhaize's terms and applicable law.

### Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, or connected to Delhaize or Ahold Delhaize. All product data belongs to its respective owners.

# Actor input Schema

## `searchQuery` (type: `string`):

Search for products by name or keyword (e.g., 'melk', 'koffie', 'pasta'). Leave empty and set a Category to browse a category instead.

## `category` (type: `string`):

Browse a whole category instead of searching. Use a Delhaize category code (e.g. 'v2DAI' for dairy, 'v2FRU' for fruit & veg). When set, Search Query is ignored.

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

Maximum number of products to return.

## `language` (type: `string`):

Language for product names and descriptions.

## `sha256Hash` (type: `string`):

Override the GraphQL persisted-query hash. Only needed if runs start failing with 'PersistedQueryNotFound' after a Delhaize site update. Leave empty to use the built-in default.

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

Proxy settings. Belgian proxies are recommended for correct prices and to avoid rate-limiting.

## Actor input object example

```json
{
  "searchQuery": "melk",
  "maxResults": 20,
  "language": "nl",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}
```

# 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 = {
    "searchQuery": "melk",
    "maxResults": 20,
    "language": "nl",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "BE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/delhaize-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 = {
    "searchQuery": "melk",
    "maxResults": 20,
    "language": "nl",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "BE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/delhaize-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 '{
  "searchQuery": "melk",
  "maxResults": 20,
  "language": "nl",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}' |
apify call studio-amba/delhaize-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/delhaize-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/yaX4YmU0LUaqZOTyX/builds/BZ12PefTqSDcGFZvk/openapi.json