Aldi UK API · Endpoint

Aldi UK Category Products API

Q: What do I send?

Send category_id. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds aldi.category.products.list, checks its price and runs it with the same credits as the REST API.

List products from a Aldi UK grocery category with published prices and supported listing continuation.

5 credits per call
Failed calls are free
Updated 14 Oct 2026
aldi.category.products.list

Start free, 100 credits API reference

Response completed

{  "has_next": true,  "page": 1,  "total_count": 34,  "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": "1 L",      "retailer_product_id": "000000000000416563",      "price": {        "amount": 0.95,        "currency": "GBP"      },      "unit_price": {        "amount": 0.95,        "currency": "GBP",        "unit": "per_litre"      },      "member_prices": [],      "promotions": []    }  ]}

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
category_id	string	yes	Category identifier.	1588161416978051001
page	integer	no	One-based result page to fetch. From 1 to 100.

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	Example
products[].name	string	UHT Semi Skimmed Milk
products[].price	object	2 fields
products[].available	null	null
products[].brand	string	COWBELLE
products[].gtin	null	null
products[].image	string	https://dm.emea.cms.aldi.cx/is/image/aldiprodeu/product/jpg/sca…
products[].member_prices	array	empty in this sample
products[].pack_size	string	1 L
products[].price.amount	number	0.95
products[].price.currency	string	GBP
products[].promotions	array	empty in this sample
products[].retailer_product_id	string	000000000000416563
products[].unit_price	object	3 fields
products[].unit_price.amount	number	0.95
products[].unit_price.currency	string	GBP
products[].unit_price.unit	string	per_litre
has_next	boolean	true
page	integer	1
products	array	1 records
total_count	integer	34

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

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));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, get the Aldi UK category products for category id "1588161416978051001". Tell me what it costs before you run it, then show the results as a table.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Aldi UK