Aldi UK grocery shelf prices and product labels API & Scraper
Aldi UK grocery shelf prices and product labels API returns live Aldi UK grocery shelf prices and product labels data as clean JSON for aldi uk grocery shelf prices and product labels The primary endpoint, search, returns products with published GBP pack/unit prices, promotions, category scope, 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 UK grocery shelf prices 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, promotions, product/detail, categories. 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-uk/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk",
"brandName": [
"COWBELLE"
],
"limit": 12
}
}{
"ok": true,
"meta": {
"api": "aldi-uk",
"endpoint": "search",
"mode": "live",
"latency_ms": 1193.2,
"record_count": 12,
"bytes": 21337,
"cache_hit": false,
"warnings": [
"Unknown parameters ignored: include_pii"
],
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "be79ee7d55fc4450",
"queue_ms": 1.1
},
"data": {
"products": [
{
"id": "000000000000543221",
"title": "Chocolate Milk",
"brand": "COWBELLE",
"url": "https://www.aldi.co.uk/product/cowbelle-chocolate-milk-000000000000543221",
"price_gbp": 0.95,
"price_display": "£0.95",
"currency": "GBP",
"regular_price_gbp": 0.95,
"price_basis": "published_pack",
"price_mismatch": false,
"unit_price_gbp": 0.95,
"unit_price_display": "£0.95/1 L",
"pack_size": "1 L",
"promotion": null,
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
}
],
"range_type": "grocery",
"is_grocery": true,
"images": [
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]",
"display_name": "[trimmed-depth]"
}
],
"weight_type": "0",
"availability": {
"store_stock": "unknown",
"source_not_for_sale": true,
"source_discontinued": false
}
},
{
"id": "000000000000422329",
"title": "Lactose Free Milk",
"brand": "COWBELLE",
"url": "https://www.aldi.co.uk/product/cowbelle-lactose-free-milk-000000000000422329",
"price_gbp": 0.99,
"price_display": "£0.99",
"currency": "GBP",
"regular_price_gbp": 0.99,
"price_basis": "published_pack",
"price_mismatch": false,
"unit_price_gbp": 0.99,
"unit_price_display": "£0.99/1 L",
"pack_size": "1 L",
"promotion": null,
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
}
],
"range_type": "grocery",
"is_grocery": true,
"images": [
{
"url": "[trimmed-depth]",
"asset_type": "[trimmed-depth]",
"mime_type": "[trimmed-depth]",
"alt": "[trimmed-depth]",
"display_name": "[trimmed-depth]"
}
],
"weight_type": "0",
"availability": {
"store_stock": "unknown",
"source_not_for_sale": true,
"source_discontinued": false
}
},
{
"id": "000000000755310001",
"title": "Strawberry Flavoured Milk",
"brand": "COWBELLE",
"url": "https://www.aldi.co.uk/product/cowbelle-strawberry-flavoured-milk-000000000755310001",
"price_gbp": 0.95,
"price_display": "£0.95",
"currency": "GBP",
"regular_price_gbp": 0.95,
"price_basis": "published_pack",
"price_mismatch": false,
"unit_price_gbp": 0.95,
"unit_price_display": "£0.95/1 L",
"pack_size": "1 L",
"promotion": null,
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"urlSlugText": "[trimmed-depth]"
}
],
"range_type": "grocery",
"is_grocery": true,
"images": [],
"weight_type": "0",
"availability": {
"store_stock": "unknown",
"source_not_for_sale": true,
"source_discontinued": false
}
}
],
"total": 26,
"offset": 0,
"limit": 12,
"page": 1,
"last_page": 3,
"has_more": true,
"page_clamped": false,
"facets": [
{
"name": "category-tree",
"localizedName": "Category",
"docCount": 26,
"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]"
}
]
},
{
"name": "theme",
"localizedName": "Theme",
"docCount": 26,
"activeValue": [],
"config": {
"parameterName": "theme",
"type": "value",
"isMultiValue": true,
"componentName": "multi-select",
"component": {
"name": "[trimmed-depth]",
"valueActive": "[trimmed-depth]",
"valueInactive": "[trimmed-depth]"
}
},
"stats": null,
"values": []
},
{
"name": "brand-name",
"localizedName": "Brand",
"docCount": 89,
"activeValue": [
"COWBELLE"
],
"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]"
}
]
}
],
"sort_options": [
{
"parameterName": "sort",
"parameterValue": "relevance",
"localizedName": "Relevance",
"isActive": true
},
{
"parameterName": "sort",
"parameterValue": "name_asc",
"localizedName": "Name (A to Z)",
"isActive": false
},
{
"parameterName": "sort",
"parameterValue": "name_desc",
"localizedName": "Name (Z to A)",
"isActive": false
}
],
"spelling_suggestion": null,
"keyword_redirect": null,
"coverage": "Public online-listed assortment; not the complete store range; SpecialBuys identified separately."
}
}What the Aldi UK grocery shelf prices and product labels API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search groceries, categories or dated campaigns; query, categoryKey or promotionKey is required. | Pricing teams call search to search groceries, categories or dated campaigns; query, categoryKey or promotionKey is required.. | query, promotionKey, categoryKey, brandName, categoryTree, ... |
| promotions | Discover public dated campaigns and themes; grocery offers and merchandise are mixed. | Marketplace operators call promotions to discover public dated campaigns and themes; grocery offers and merchandise are mixed.. | none |
| product/detail | Read the full public product record and label. | Catalog enrichment teams call product/detail to read the full public product record and label.. | id |
| categories | Get the current category tree. | Retail analysts call categories to get the current category tree.. | none |
| availability | Get indicative store stock. id plus location, store_id, or latitude AND longitude is required. | Pricing teams call availability to get indicative store stock. | id |
Call search from your stack
curl -X POST https://api.reefapi.com/aldi-uk/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","brandName":["COWBELLE"],"limit":12}'import requests
r = requests.post(
"https://api.reefapi.com/aldi-uk/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"brandName": [
"COWBELLE"
],
"limit": 12
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/aldi-uk/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk",
"brandName": [
"COWBELLE"
],
"limit": 12
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.aldi-uk.search with {"query":"milk","brandName":["COWBELLE"],"limit":12}.Who uses this API and why
- Pricing teams use Aldi UK grocery shelf prices and product labels to search groceries, categories or dated campaigns; query, categoryKey or promotionKey is required..
- Marketplace operators use Aldi UK grocery shelf prices and product labels to discover public dated campaigns and themes; grocery offers and merchandise are mixed..
- Catalog enrichment teams use Aldi UK grocery shelf prices and product labels to read the full public product record and label..
- Retail analysts use Aldi UK grocery shelf prices and product labels to get the current category tree..
- Pricing teams use Aldi UK grocery shelf prices and product labels to get indicative store stock.
Questions developers ask before integrating
What is the Aldi UK grocery shelf prices and product labels API?
Aldi UK grocery shelf prices and product labels API is a ReefAPI endpoint group for aldi uk grocery shelf prices and product labels It returns live JSON through POST requests under /aldi-uk/v1.
Is the Aldi UK grocery shelf prices and product labels API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Aldi UK grocery shelf prices and product labels calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Aldi UK grocery shelf prices and product labels login or account?
No login to Aldi UK grocery shelf prices 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 UK grocery shelf prices 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 UK grocery shelf prices and product labels API use?
Aldi UK grocery shelf prices 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 UK grocery shelf prices and product labels from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call aldi-uk actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Aldi UK grocery shelf prices and product labels API an Aldi UK grocery shelf prices and product labels scraper?
It is the managed alternative to a DIY Aldi UK grocery shelf prices 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 uk grocery shelf prices and product labels back as clean JSON.
Why does my Aldi UK grocery shelf prices and product labels scraper keep getting blocked?
Most Aldi UK grocery shelf prices 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.