ALDI APIaldi.be ↗
Search ALDI Belgium products, fetch current and next week's promotions, and retrieve full product details including prices, brand, and images via 4 endpoints.
What is the ALDI API?
The ALDI Belgium API provides 4 endpoints to query the aldi.be product catalog and weekly promotional offers. Use search_products to search by name, brand, or numeric product ID and receive paginated results with prices, base unit prices, and image URLs. get_product_details returns full metadata for a single product including promotional validity dates, sales unit descriptions, and hierarchical category data.
curl -X POST 'https://api.parse.bot/scraper/d6ce3e50-422d-475c-a2e3-112a742799df/search_products' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "1",
"query": "melk"
}'Search ALDI Belgium products by name (e.g. 'melk') or exact product ID (e.g. '0602'). Returns paginated results with product metadata, current prices, promotional strike prices when available, base price per unit, brand, categories, and image URLs. Results are ordered by relevance. Each page returns up to 20 products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| queryrequired | string | Search term: a product name (e.g. 'melk', 'chocolade'), brand, category, or exact numeric product ID (e.g. '0602'). When a product ID is used, the exact match appears first. |
{
"type": "object",
"fields": {
"page": "current page number",
"total": "total number of matching products",
"products": "array of product objects with id, name, brand, description, pricing, categories, and image",
"total_pages": "total number of pages available"
}
}About the ALDI API
Product Search and Details
search_products (POST) accepts a query string — a product name like 'melk' or 'chocolade', a brand, a category term, or an exact numeric product ID such as '0602'. It returns paginated results (controlled by the page integer parameter) with each product object carrying an id, name, brand, description, current price in EUR, promotional strike prices when available, base_price per unit, categories, and image URLs. The total and total_pages fields let you walk through full result sets.
get_product_details (GET) takes a product_id — either a numeric ID like '3005710' or a slug like 'halfvolle-melk-0602' — and returns a richer single-product payload: promo_text label, sales_unit package description, an images array with typed URLs and titles, promotional price validity dates, and the full categories array. The price field is null when no price is currently set for the product.
Promotions
Two endpoints cover weekly promotions. get_promotions (GET) accepts a week parameter ('current' or 'next') and returns enriched promotion groups — each with title, start_date, end_date, category, and a products array containing full price, strike price, promo text, and image data per product. list_promotions (GET) covers the same week parameter but returns only shallow metadata: group titles, validity dates, teaser images, and linked retailer product IDs, without per-product enrichment. Use list_promotions when you only need the promotion structure, and get_promotions when you need product-level detail within each offer group.
The ALDI API is a managed, monitored endpoint for aldi.be — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when aldi.be changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official aldi.be API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track ALDI Belgium price changes over time by polling
search_productson specific product IDs and recording thepriceandbase_pricefields. - Build a weekly deals digest by fetching
get_promotionswithweek='next'to surface upcoming offers with theirstart_date,end_date, andpromo_text. - Populate a grocery comparison tool with product
brand,description, and per-unitbase_pricefromget_product_details. - Monitor promotional category coverage each week using
list_promotionsto extract groupcategoryandtitlefields without fetching full product payloads. - Index ALDI Belgium product images for a recipe or meal-planning app using the
imagesarray returned byget_product_details. - Alert users when a specific product enters a promotion by comparing
promo_textacross successive calls tosearch_products.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ALDI Belgium offer an official developer API?+
What is the difference between `get_promotions` and `list_promotions`?+
get_promotions returns fully enriched promotion groups including per-product prices, strike prices, promo texts, and images. list_promotions returns only the shallow group-level metadata — titles, dates, category, teaser images, and linked product IDs — without making per-product calls. Use list_promotions when you need a quick summary of what promotions exist; use get_promotions when you need product-level detail within each group.Can I retrieve historical promotions or prices from previous weeks?+
get_promotions and list_promotions endpoints accept only 'current' or 'next' as the week parameter. Historical promotion data is not covered. You can fork this API on Parse and revise it to store promotion snapshots over time if historical tracking is needed.