↑ ↓ to move ↵ to open

Waitrose API reference

See what Waitrose charges, what it has on offer and how shoppers rate each product, for any search term or aisle.

At a glance

Platform ID
waitrose
Endpoints
8
Price
From 1 credit per call; failed calls are free
Pin in MCP
https://data.upscrape.com/mcp?platforms=waitrose
Pin tools
OpenAPI
openapi.json
Download

Waitrose does not offer a public API for its product data. Upscrape's Waitrose API returns what waitrose.com shows: each product's price, pack size, price per litre or kilo, star rating and offers, as JSON.

Offers come by collection: half price, save a third, percentage off, multibuy and myWaitrose. A myWaitrose member price stays separate from the shelf price, so a report never mixes the two.

Every product carries its average star rating and how many ratings it has. For the words behind them, read the reviews, sorted newest, highest, lowest or most helpful, or only those with a given star rating.

Endpoints

Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.

EndpointWhat it returnsPrice
waitrose.products.search Search Waitrose by keyword, such as whole milk. 10 credits
waitrose.promotions.list List one offer collection, such as half price, multibuy or myWaitrose, with each product's price and the offer's end date. 10 credits
waitrose.product.detail.get Read one product by its Waitrose product ID or link, with its rating and, where Waitrose shows it, the barcode. 1 credit
waitrose.category.products.list List the products in a Waitrose aisle, such as Milk, about 50 at a time, with an offset to read further. 10 credits
waitrose.product.reviews.list Read up to 50 reviews of a product at a time, sorted or filtered by star rating. 5 credits
waitrose.product.rating.get Get a product's average star rating and number of ratings, without the rest of the product. 1 credit
waitrose.product.sellers.list See who sells a product on its Waitrose page, and at what price. 1 credit
waitrose.categories.list Get Waitrose's full category tree, with the IDs the aisle endpoint takes. 1–3 credits

What to know

  • Offers carry an end date Many Waitrose offers come with the date they end. Store it so an expired offer never shows as current in a report.
  • Read each product's own offers A product listed in an offer collection can come back with no offer attached when Waitrose shows none on it. Trust the product's offers, not the collection name.
  • Weigh a rating by its count The average rating comes with the number of ratings behind it. A 5.0 from 2 ratings is weaker evidence than a 4.6 from 800, so weigh both before you rank.
  • Pages move by offset Search, aisle and offer lists return about 50 products at a time with next_offset. Send it as offset to read on, and drop repeats by product ID when you join pages.
  • Compare by unit price Waitrose sells the same milk in 2 and 4 pint packs. Price per litre or kilo is the fair comparison; keep the pack size beside it.

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