Lidl API · Endpoint

Lidl Categories API

Q: Can my AI agent call it?

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

Get Lidl's top online categories for a country, with product counts and the links to browse them.

1 credit per call
Failed calls are free
Updated 6 Oct 2026
lidl.categories.list

Start free, 100 credits API reference

Response completed

{  "categories": [    {      "count": 244,      "id": "10068374",      "label": "Food & Drink",      "url": "https://www.lidl.co.uk/q/api/search?assortment=GB&locale=en_GB&version=v2.0.0&category=Food+%26+Drink"    },    {      "count": 47,      "id": "10068166",      "label": "Kitchen & Household",      "url": "https://www.lidl.co.uk/q/api/search?assortment=GB&locale=en_GB&version=v2.0.0&category=Kitchen+%26+Household"    }  ]}

3 rows

#	Count	Label	Id	Url
1	244	Food & Drink	10068374	https://www.lidl.co.uk/q/api/search?assortment=GB&locale=en_GB&…
2	47	Kitchen & Household	10068166	https://www.lidl.co.uk/q/api/search?assortment=GB&locale=en_GB&…
3	100	DIY & Garden	10068222	https://www.lidl.co.uk/q/api/search?assortment=GB&locale=en_GB&…

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
country	string	no	GB, DE or FR.	GB

Response

Fields it returns

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

Field	Type	What it is	Example
categories[].count	integer	How many products the category holds.	244
categories[].id	string	Lidl's ID for the category.	10068374
categories[].label	string	The category name as Lidl shows it.	Food & Drink
categories[].url	string	The page on Lidl's site.	https://www.lidl.co.uk/q/api/search?assortment=GB&locale=en_GB&…
categories	array	Lidl's top-level categories.	3 records

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": "lidl.categories.list",  "input": {    "country": "GB"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "lidl.categories.list",  "input": {    "country": "GB"  }}''')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": "lidl.categories.list",  "input": {    "country": "GB"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));