# 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 - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 ## 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. ### 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" } } ``` # 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": "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 '' with your token. client = ApifyClient("") # 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("💾 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": "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": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/delhaize-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Delhaize Scraper — Belgian Supermarket Products & Prices", "description": "Scrape products, prices, unit prices, promotions and Nutri-Score from Delhaize.be. Search by keyword or browse by category. No login or cookies required.", "version": "0.1", "x-build-id": "SGCKnQoakqYLBke38" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~delhaize-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-delhaize-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~delhaize-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-delhaize-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~delhaize-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-delhaize-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 for products by name or keyword (e.g., 'melk', 'koffie', 'pasta'). Leave empty and set a Category to browse a category instead." }, "category": { "title": "Category Code", "type": "string", "description": "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": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of products to return.", "default": 50 }, "language": { "title": "Language", "enum": [ "nl", "fr" ], "type": "string", "description": "Language for product names and descriptions.", "default": "nl" }, "sha256Hash": { "title": "Persisted Query Hash (advanced)", "type": "string", "description": "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": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Belgian proxies are recommended for correct prices and to avoid rate-limiting." } } }, "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 } } } } } } } } } } ```