Waitrose API reference
See what Waitrose charges, what it has on offer and how shoppers rate each product, for any search term or aisle.
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.
| Endpoint | What it returns | Price |
|---|---|---|
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.