ALDI APIaldi.be ↗
Search ALDI Belgium products by name or ID, fetch current and next-week promotions, and retrieve detailed product metadata including prices and images.
What is the ALDI API?
The ALDI Belgium API exposes 3 endpoints covering product search, promotion listings, and individual product details from aldi.be. The search_products endpoint accepts a product name like 'melk' or a numeric ID and returns paginated results with pricing, brand, categories, and image URLs. The get_promotions endpoint surfaces grouped weekly deals with validity dates, while get_product_details delivers the full metadata for a single product.
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
The search_products endpoint accepts a query string — a product name (e.g. chocolade), brand, category keyword, or exact numeric product ID (e.g. 0602) — and returns paginated results via the page parameter. Each product object in the products array includes id, name, brand, description, current price, promotional strike prices, base_price per unit, categories, and image URLs. The response also exposes total and total_pages so you can iterate through all matching results.
Promotions
get_promotions accepts a single optional week parameter set to 'current' or 'next', defaulting to current-week offers. It returns an array of promotion groups, each with a title, start_date, end_date, category, and a nested products array. Product entries in promotions include strike prices, promo_text labels, and images, making it straightforward to track the offer lifecycle across two weeks.
Product Details
get_product_details takes a product_id that can be either a numeric ID (3005710) or a slug (halfvolle-melk-0602). The response includes name, brand, price in EUR, base_price, sales_unit, promo_text, promotional prices with validity dates, categories, hierarchical category data, and an images array with type, URL, and title per image. Fields like brand and price can be null when not set on the source listing.
Coverage Notes
All data reflects the Belgian ALDI storefront (aldi.be) and prices are in EUR. Promotions cover at most two periods — current and next week — matching what ALDI Belgium publishes. Product availability and pricing can change weekly, so freshness depends on how recently the endpoint was called.
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?+
- Monitor ALDI Belgium weekly promotions and alert customers when specific product categories go on sale
- Build a price-tracker that compares ALDI Belgium's current price against promotional strike prices for a given product
- Aggregate grocery product metadata (name, brand, categories, images) for a Belgian comparison shopping tool
- Search ALDI Belgium by product ID to auto-populate a product database with descriptions and base unit prices
- Extract promo_text labels and validity dates to populate a deal-aggregation newsletter
- Identify base_price per unit across search results to rank ALDI Belgium products by value for money
- Retrieve product slugs and images to populate a recipe app with linked grocery ingredients from ALDI Belgium
| 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.