↑ ↓ to move ↵ to open
Aldi UK API reference

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
POST /execute
Run an endpoint
MCP tool when pinned
aldi__category__products__list
Pin tools
OpenAPI
openapi.json
Download

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"  }}'

Input

FieldTypeRequiredWhat it doesExample
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:

results[0].data
{  "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

FieldTypeWhat it isExample
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.