Aldi UK Category Products
aldi.category.products.list
List the products in one Aldi category, such as Milk, 30 to a page, with prices and pack sizes.
At a glance
- Endpoint ID
aldi.category.products.list- Price
- 5 credits per call; failed calls are free
- Runs for up to
- 30 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "aldi.category.products.list", "input": { "category_id": "1588161416978051001" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "aldi.category.products.list", "input": { "category_id": "1588161416978051001" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "aldi.category.products.list", "input": { "category_id": "1588161416978051001" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
category_id |
string | yes | A category ID from the categories endpoint, such as 1588161416978051001 for Milk. | 1588161416978051001 |
page |
integer | no | Which page of 30 products to return, starting at 1. |
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
{ "has_next": true, "page": 1, "total_count": 35, "products": [ { "name": "UHT Semi Skimmed Milk", "available": null, "brand": "COWBELLE", "gtin": null, "image": "https://dm.emea.cms.aldi.cx/is/image/aldiprodeu/product/jpg/scaleWidth/500/ac801d8b-1277-411d-9f97-f13a805607a6/UHT%20Semi%20Skimmed%20Milk", "pack_size": null, "retailer_product_id": "000000000000416563", "unit_price": null, "url": "https://www.aldi.co.uk/product/cowbelle-uht-semi-skimmed-milk-000000000000416563", "price": { "amount": 0.95, "currency": "GBP" }, "member_prices": [], "promotions": [] }, { "name": "UHT Red Skimmed Milk", "available": null, "brand": "COWBELLE", "gtin": null, "image": "https://dm.emea.cms.aldi.cx/is/image/aldiprodeu/product/jpg/scaleWidth/500/d5a9ef42-80e2-4dce-a6f2-759326efd0b7/UHT%20Red%20Skimmed%20Milk", "pack_size": "1 l", "retailer_product_id": "000000000000416564", "url": "https://www.aldi.co.uk/product/cowbelle-uht-red-skimmed-milk-000000000000416564", "price": { "amount": 0.95, "currency": "GBP" }, "unit_price": { "amount": 0.95, "currency": "GBP", "unit": "per_litre" }, "member_prices": [], "promotions": [] } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
products[].name |
string | The name as Aldi shows it. | UHT Semi Skimmed Milk |
products[].brand |
string | The brand or Aldi label, in capitals as the site prints it. | COWBELLE |
products[].pack_size |
null | The pack size, such as 2.272 l; empty when Aldi gives none. | null |
products[].price.amount |
number | The amount, in the currency beside it. | 0.95 |
products[].retailer_product_id |
string | Aldi's 18-digit product number; the product endpoint takes it. | 000000000000416563 |
products[].price |
object | The price of one pack. | 2 fields |
products[].available |
null | Whether the product can be bought; Aldi does not publish this, so it stays empty. | null |
products[].gtin |
null | The barcode, when Aldi gives one; usually empty. | null |
products[].image |
string | The product picture. | https://dm.emea.cms.aldi.cx/is/image/aldiprodeu/product/jpg/sca… |
products[].member_prices |
array | Member-only prices; Aldi has none, so this is empty. | empty in this sample |
products[].price.currency |
string | GBP, pounds sterling. | GBP |
products[].promotions |
array | The offers on the product, such as a price drop. | empty in this sample |
products[].unit_price |
null | The price per kilo, litre or item; empty when Aldi shows none. | null |
products[].url |
string | The page on aldi.co.uk. | https://www.aldi.co.uk/product/cowbelle-uht-semi-skimmed-milk-0… |
has_next |
boolean | Whether another page follows. | true |
page |
integer | Which page this is. | 1 |
products |
array | The products on this page. | 30 records |
total_count |
integer | How many products match in total. | 35 |
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other Aldi UK endpoints
Something missing or unclear? Ask the team that builds the Aldi UK endpoints.