Iceland API · Endpoint

Iceland Promotions API

Q: Can my AI agent call it?

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

Browse products and offers in the public Iceland promotions collection with published price and deal information.

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

Start free, 100 credits API reference

Response completed

{  "has_next": true,  "total": 3811,  "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
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	3811

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.promotions.list",  "input": {    "page": 1  }}'

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