Waitrose API · Endpoint

Waitrose Offers API

Q: Can my AI agent call it?

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

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

8 credits per call
Failed calls are free
Updated 6 Oct 2026
waitrose.promotions.list

Start free, 100 credits API reference

Response completed

{  "next_offset": null,  "offset": 0,  "returned": 1,  "total_products": 1,  "items": [    {      "name": "Waitrose & Partners Food magazine",      "available": null,      "brand": "Waitrose Ltd",      "gtin": null,      "image": "https://ecom-su-static-prod.wtrecom.com/images/products/9/LN_065244_BP_9.jpg",      "pack_size": "Each",      "rating_average": 4.2802,      "rating_count": 1142,      "retailer_product_id": "065244-33064-33065",      "url": "https://www.waitrose.com/ecom/products/waitrose-partners-food-magazine/065244-33064-33065",      "price": {        "amount": 5,        "currency": "GBP"      },      "unit_price": {        "amount": 5,        "currency": "GBP",        "unit": "each"      },      "member_prices": [        {          "promotion_id": "-900108360",          "scheme": "mywaitrose",          "price": {            "amount": 0,            "currency": "GBP"          }        }      ],      "promotions": [        {          "buy_quantity": null,          "description": "MW Free Food Magazine",          "end": "2029-01-30",          "for_price": null,          "id": "-900108360",          "start": null,          "type": "member"        }      ]    }  ]}

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
collection	string	no	Allowed values: `all`, `half_price`, `save_third`, `percentage_off`, `multibuy`, `mywaitrose`.	mywaitrose
offset	integer	no	Zero-based number of results to skip. From 0 to 10000.

Response

Fields it returns

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

Field	Type	Example
items[].name	string	Waitrose & Partners Food magazine
items[].member_prices[].price	object	2 fields
items[].price	object	2 fields
items[].available	null	null
items[].brand	string	Waitrose Ltd
items[].gtin	null	null
items[].image	string	https://ecom-su-static-prod.wtrecom.com/images/products/9/LN_06…
items[].member_prices	array	1 records
items[].member_prices[].promotion_id	string	-900108360
items[].member_prices[].scheme	string	mywaitrose
items[].pack_size	string	Each
items[].price.amount	integer	5
items[].price.currency	string	GBP
items[].promotions	array	1 records
items[].promotions[].buy_quantity	null	null
items[].promotions[].description	string	MW Free Food Magazine
items[].promotions[].end	string	2029-01-30
items[].promotions[].for_price	null	null
items[].promotions[].id	string	-900108360
items[].promotions[].start	null	null
items[].promotions[].type	string	member
items[].rating_average	number	4.28
items[].rating_count	integer	1142
items[].retailer_product_id	string	065244-33064-33065
items[].unit_price	object	3 fields
items[].unit_price.amount	integer	5
items[].unit_price.currency	string	GBP
items[].unit_price.unit	string	each
items[].url	string	https://www.waitrose.com/ecom/products/waitrose-partners-food-m…
items	array	1 records
next_offset	null	null
offset	integer	0
returned	integer	1
total_products	integer	1

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": "waitrose.promotions.list",  "input": {    "collection": "mywaitrose"  }}'

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