Iceland API · Endpoint

Iceland 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 iceland.category.products.list, checks its price and runs it with the same credits as the REST API.

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

5 credits per call
Failed calls are free
Updated 6 Oct 2026
iceland.category.products.list

Start free, 100 credits API reference

Response completed

{  "has_next": true,  "total": 180,  "items": [    {      "name": "Iceland British Semi-Skimmed Milk 2 Litres",      "price": 1.65,      "available": true,      "brand": "Iceland",      "currency": "GBP",      "gtin": null,      "pack_size": "2l",      "retailer_product_id": "19492",      "unit_price": {        "amount": 0.83,        "unit": "per_litre"      },      "member_prices": [],      "promotions": [        {          "buy_quantity": 2,          "description": "2 for £3.00",          "end": null,          "for_price": 3,          "id": "12660",          "start": null,          "type": "multibuy"        }      ]    }  ]}

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.	CHLMLK
page	integer	no	One-based result page to fetch. From 1 to 100.	1

Response

Fields it returns

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

Field	Type	Example
items[].name	string	Iceland British Semi-Skimmed Milk 2 Litres
items[].price	number	1.65
items[].available	boolean	true
items[].brand	string	Iceland
items[].currency	string	GBP
items[].gtin	null	null
items[].member_prices	array	empty in this sample
items[].pack_size	string	2l
items[].promotions	array	1 records
items[].promotions[].buy_quantity	integer	2
items[].promotions[].description	string	2 for £3.00
items[].promotions[].end	null	null
items[].promotions[].for_price	integer	3
items[].promotions[].id	string	12660
items[].promotions[].start	null	null
items[].promotions[].type	string	multibuy
items[].retailer_product_id	string	19492
items[].unit_price	object	2 fields
items[].unit_price.amount	number	0.83
items[].unit_price.unit	string	per_litre
has_next	boolean	true
items	array	1 records
total	integer	180

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": "iceland.category.products.list",  "input": {    "category_id": "CHLMLK",    "page": 1  }}'

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