↑ ↓ to move ↵ to open
Waitrose API reference

Waitrose Products Search

waitrose.products.search

Search Waitrose by keyword, such as whole milk. Each product has its price, unit price, star rating and offers.

At a glance

Endpoint ID
waitrose.products.search
Price
8 credits per call; failed calls are free
Runs for up to
45 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
waitrose__products__search
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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.products.search",  "input": {    "query": "whole milk"  }}'

Input

FieldTypeRequiredWhat it doesExample
query string yes What to search for, such as whole milk. whole milk
offset integer no How many products or reviews to skip, from next_offset in the previous response.

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "next_offset": null,  "offset": 0,  "returned": 27,  "total_products": 27,  "items": [    {      "name": "Essential British Free Range Whole Milk 4 Pints",      "available": true,      "brand": "Waitrose Ltd",      "gtin": null,      "image": "https://ecom-su-static-prod.wtrecom.com/images/products/9/LN_053404_BP_9.jpg",      "pack_size": "2.272litre",      "rating_average": 4.6317,      "rating_count": 372,      "retailer_product_id": "053404-26711-26712",      "url": "https://www.waitrose.com/ecom/products/essential-british-free-range-whole-milk-4-pints/053404-26711-26712",      "price": {        "amount": 1.75,        "currency": "GBP"      },      "unit_price": {        "amount": 0.77,        "currency": "GBP",        "unit": "per_litre"      },      "member_prices": [],      "promotions": []    },    {      "name": "Essential British Free Range Whole Milk 2 Pints",      "available": true,      "brand": "Waitrose Ltd",      "gtin": null,      "image": "https://ecom-su-static-prod.wtrecom.com/images/products/9/LN_053403_BP_9.jpg",      "pack_size": "1.136litre",      "rating_average": 4.5895,      "rating_count": 229,      "retailer_product_id": "053403-26709-26710",      "url": "https://www.waitrose.com/ecom/products/essential-british-free-range-whole-milk-2-pints/053403-26709-26710",      "price": {        "amount": 1.25,        "currency": "GBP"      },      "unit_price": {        "amount": 1.11,        "currency": "GBP",        "unit": "per_litre"      },      "member_prices": [],      "promotions": [        {          "buy_quantity": null,          "description": "New Lower Price",          "end": "2026-12-08",          "for_price": null,          "id": "554890",          "start": null,          "type": "price_cut"        }      ]    }  ]}

Fields

FieldTypeWhat it isExample
items[].name string The name as Waitrose shows it, or the seller's name. Essential British Free Range Whole Milk 4 Pints
items[].brand string The product's brand; Waitrose Ltd for Waitrose's own. Waitrose Ltd
items[].pack_size string The pack size, such as 2.272litre. 2.272litre
items[].price.amount number The amount in pounds. 1.75
items[].unit_price.amount number The amount in pounds. 0.77
items[].unit_price.unit string What the unit price is per, such as per_litre. per_litre
items[].rating_average number The product's average star rating. 4.63
items[].rating_count integer How many star ratings the product has. 372
items[].retailer_product_id string Waitrose's product ID; the product, rating, review and seller endpoints take it. 053404-26711-26712
items[].price object The shelf price of one pack. 2 fields
items[].available boolean True for a product the shop lists; the product endpoint reads the page's own in-stock or out-of-stock flag. true
items[].gtin null The barcode, when Waitrose shows one. null
items[].image string The product picture. https://ecom-su-static-prod.wtrecom.com/images/products/9/LN_05…
items[].member_prices array myWaitrose member prices, kept apart from the shelf price. empty in this sample
items[].price.currency string GBP, pounds sterling. GBP
items[].promotions array The offers on the product. empty in this sample
items[].unit_price object The price per litre, kilo or item. 3 fields
items[].unit_price.currency string GBP, pounds sterling. GBP
items[].url string The page on waitrose.com. https://www.waitrose.com/ecom/products/essential-british-free-r…
items array The products on this page. 27 records
next_offset null Send it as offset to read the next page; empty on the last page. null
offset integer Where this page starts. 0
returned integer How many entries this page holds. 27
total_products integer How many products there are in total. 27

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Waitrose endpoints

Something missing or unclear? Ask the team that builds the Waitrose endpoints.