Aldi Australia grocery shelf prices, Special Buys and product labels API & Scraper
Aldi Australia grocery shelf prices, Special Buys and product labels API returns live Aldi Australia grocery shelf prices, Special Buys and product labels data as clean JSON for aldi australia grocery shelf prices, special buys and product labels The primary endpoint, search, returns Products with national AUD shelf and unit prices, pack size, deal ranges, Special Buys dates, pagination and live facets.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Aldi Australia grocery shelf prices, Special Buys and product labels scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, deals, promotions, product/detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/aldi-au/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk",
"limit": 12
}
}{
"ok": true,
"meta": {
"api": "aldi-au",
"endpoint": "search",
"mode": "live",
"latency_ms": 1081,
"record_count": 12,
"bytes": 32231,
"cache_hit": false,
"warnings": [
"Unknown parameters ignored: include_pii"
],
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "4ccecfc625b345fd",
"queue_ms": 2.2,
"fetched_at": "2026-10-13T10:56:26.518Z"
},
"data": {
"products": [
{
"id": "000000000538441002",
"title": "Milk Mouse - Milk Chocolate 168g",
"brand": "CHOCEUR",
"url": "https://www.aldi.com.au/product/choceur-milk-mouse-milk-chocolate-168g-000000000538441002",
"price_aud": 3.99,
"price_display": "$3.99",
"currency": "AUD",
"regular_price_aud": 3.99,
"price_basis": "published_pack",
"price_mismatch": false,
"unit_price_aud": 2.38,
"unit_price_display": "$2.38 per 100 g",
"pack_size": "168 g",
"bottle_deposit_aud": null,
"age_restriction": null,
"alcohol": null,
"is_special_buy": false,
"promotion": null,
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
}
],
"images": [
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
},
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
},
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
}
],
"weight_type": "0",
"availability": {
"store_stock": "unknown",
"source_not_for_sale": true,
"source_discontinued": false
}
},
{
"id": "000000000000545135",
"title": "Milk Frother",
"brand": "EXPRESSI",
"url": "https://www.aldi.com.au/product/expressi-milk-frother-000000000000545135",
"price_aud": 31.99,
"price_display": "$31.99",
"currency": "AUD",
"regular_price_aud": 31.99,
"price_basis": "published_pack",
"price_mismatch": false,
"unit_price_aud": null,
"unit_price_display": null,
"pack_size": null,
"bottle_deposit_aud": null,
"age_restriction": null,
"alcohol": null,
"is_special_buy": false,
"promotion": null,
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
}
],
"images": [
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
},
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
},
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
}
],
"weight_type": "0",
"availability": {
"store_stock": "unknown",
"source_not_for_sale": true,
"source_discontinued": false
}
},
{
"id": "000000000000398691",
"title": "Light Milk 2L",
"brand": "FARMDALE",
"url": "https://www.aldi.com.au/product/farmdale-light-milk-2l-000000000000398691",
"price_aud": 3.39,
"price_display": "$3.39",
"currency": "AUD",
"regular_price_aud": 3.39,
"price_basis": "published_pack",
"price_mismatch": false,
"unit_price_aud": 1.7,
"unit_price_display": "$1.70 per 1 L",
"pack_size": "2 l",
"bottle_deposit_aud": null,
"age_restriction": null,
"alcohol": null,
"is_special_buy": false,
"promotion": null,
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
}
],
"images": [
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
},
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
},
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]"
}
],
"weight_type": "0",
"availability": {
"store_stock": "unknown",
"source_not_for_sale": true,
"source_discontinued": false
}
}
],
"total": 89,
"offset": 0,
"limit": 12,
"page": 1,
"last_page": 8,
"has_more": true,
"facets": [
{
"name": "category-tree",
"localizedName": "Category",
"docCount": 91,
"activeValue": [],
"config": {
"parameterName": "categoryTree",
"type": "value",
"isMultiValue": true,
"componentName": "category-tree",
"component": {
"name": "[trimmed-depth]",
"valueActive": "[trimmed-depth]",
"valueInactive": "[trimmed-depth]"
}
},
"stats": null,
"values": [
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
}
]
},
{
"name": "theme",
"localizedName": "Theme",
"docCount": 91,
"activeValue": [],
"config": {
"parameterName": "theme",
"type": "value",
"isMultiValue": true,
"componentName": "multi-select",
"component": {
"name": "[trimmed-depth]",
"valueActive": "[trimmed-depth]",
"valueInactive": "[trimmed-depth]"
}
},
"stats": null,
"values": [
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
}
]
},
{
"name": "brand-name",
"localizedName": "Brand Name",
"docCount": 91,
"activeValue": [],
"config": {
"parameterName": "brandName",
"type": "value",
"isMultiValue": true,
"componentName": "multi-select",
"component": {
"name": "[trimmed-depth]",
"valueActive": "[trimmed-depth]",
"valueInactive": "[trimmed-depth]"
}
},
"stats": null,
"values": [
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"docCount": "[trimmed-depth]",
"label": "[trimmed-depth]",
"isSelected": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"children": "[trimmed-depth]"
}
]
}
],
"spelling_suggestion": null,
"keyword_redirect": null,
"coverage": "Public online-listed assortment with national shelf prices; Special Buys carry an on-sale date."
}
}What the Aldi Australia grocery shelf prices, Special Buys and product labels API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search products, browse a category, read a Special Buys date, or page the whole online assortment. | Pricing teams call search to search products, browse a category, read a Special Buys date, or page the whole online assort…. | query, categoryKey, promotionKey, url, brandName, ... |
| deals | List a current Aldi deal range: Lower Prices, Super Savers or Limited Time Only. | Marketplace operators call deals to list a current Aldi deal range. | type, brandName, categoryTree, theme, sort, ... |
| promotions | List current and upcoming Special Buys dates and their themes. | Catalog enrichment teams call promotions to list current and upcoming Special Buys dates and their themes.. | none |
| product/detail | Read the full public product record and label. | Retail analysts call product/detail to read the full public product record and label.. | id |
| categories | Get the live category tree, deal ranges marked. | Pricing teams call categories to get the live category tree, deal ranges marked.. | none |
| availability | Indicative store stock for one product. id plus location, store_id, or latitude AND longitude. | Marketplace operators call availability to get indicative store stock for one product. | id |
Call search from your stack
curl -X POST https://api.reefapi.com/aldi-au/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","limit":12}'import requests
r = requests.post(
"https://api.reefapi.com/aldi-au/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"limit": 12
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/aldi-au/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk",
"limit": 12
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.aldi-au.search with {"query":"milk","limit":12}.Who uses this API and why
- Pricing teams use Aldi Australia grocery shelf prices, Special Buys and product labels to search products, browse a category, read a Special Buys date, or page the whole online assort….
- Marketplace operators use Aldi Australia grocery shelf prices, Special Buys and product labels to list a current Aldi deal range.
- Catalog enrichment teams use Aldi Australia grocery shelf prices, Special Buys and product labels to list current and upcoming Special Buys dates and their themes..
- Retail analysts use Aldi Australia grocery shelf prices, Special Buys and product labels to read the full public product record and label..
- Pricing teams use Aldi Australia grocery shelf prices, Special Buys and product labels to get the live category tree, deal ranges marked..
Questions developers ask before integrating
What is the Aldi Australia grocery shelf prices, Special Buys and product labels API?
Aldi Australia grocery shelf prices, Special Buys and product labels API is a ReefAPI endpoint group for aldi australia grocery shelf prices, special buys and product labels It returns live JSON through POST requests under /aldi-au/v1.
Is the Aldi Australia grocery shelf prices, Special Buys and product labels API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Aldi Australia grocery shelf prices, Special Buys and product labels calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Aldi Australia grocery shelf prices, Special Buys and product labels login or account?
No login to Aldi Australia grocery shelf prices, Special Buys and product labels is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Aldi Australia grocery shelf prices, Special Buys and product labels data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Aldi Australia grocery shelf prices, Special Buys and product labels API use?
Aldi Australia grocery shelf prices, Special Buys and product labels actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Aldi Australia grocery shelf prices, Special Buys and product labels from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call aldi-au actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Aldi Australia grocery shelf prices, Special Buys and product labels API an Aldi Australia grocery shelf prices, Special Buys and product labels scraper?
It is the managed alternative to a DIY Aldi Australia grocery shelf prices, Special Buys and product labels scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same aldi australia grocery shelf prices, special buys and product labels back as clean JSON.
Why does my Aldi Australia grocery shelf prices, Special Buys and product labels scraper keep getting blocked?
Most Aldi Australia grocery shelf prices, Special Buys and product labels scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.