Waitrose UK Groceries API

Waitrose grocery prices and labels, with public member offers kept separate

Waitrose UK Groceries API returns live Waitrose UK Groceries data as clean JSON for waitrose uk groceries The primary endpoint, search, returns products, shelf price in GBP, unit price, promotions, separate public myWaitrose prices, availability and source total.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Waitrose UK Groceries endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
W
/waitrose/v1

4 active endpoints, on 1 and 3 credit tiers.

  • POST/waitrose/v1/search
  • POST/waitrose/v1/category
  • POST/waitrose/v1/offers
  • POST/waitrose/v1/detail

What Waitrose UK Groceries endpoints does ReefAPI ship?

4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

4 endpoints

search

3 cr

Search the first public UK grocery result window.

required
query
optional
—

category

1 cr

First public window of a groceries category path.

required
category
optional
—

offers

1 cr

Public regular offers or the public My Waitrose Offers list.

required
—
optional
—

detail

3 cr

Full public product detail.

required
—
optional
—

Every parameter, every allowed value →

Waitrose UK Groceries API

2 of 4 endpoints, ready to run

View docs ↗

Search the first public grocery result window

3 credits1 required · 1 optional
POST/waitrose/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Waitrose UK Groceries API works

Waitrose UK Groceries is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 438 engines.

02
Call
POST /waitrose/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Find a product, then add its barcode and label

Search rows carry the composite id. Full detail publishes the barcode list and product label.

01search?query=milk&limit=3
GET/waitrose/v1/search?query=milk&limit=3

Read id, GBP shelf price and unit-price denominator from the returned products.

02detail?id=053457-26759-26760
GET/waitrose/v1/detail?id=053457-26759-26760

Read barcodes, GTIN, ingredients, nutrition and packaging for the same product.

A product record with a stable retailer id, preserved barcode strings and separate shelf/member amounts. Both measured runs matched five search ids to their full details.

request
curl -X POST https://api.reefapi.com/waitrose/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milk","limit":12}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "waitrose",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

Measured UK coverage and first-window limit

Measured on 2 October 2026 across milk, bread and laundry. Core search and detail use the first public window. Further pagination, advanced filters and unavailable-state controls are optional unqualified coverage.

Market and currency

Waitrose UK groceries, GBP

Detail sample

51 products; shelf price, unit price and GTIN filled on all 51; ingredients on 46

Listing sample

133 rows across three categories, each with title, URL, shelf price and unit price

Public member offer

Food magazine: £5.00 shelf price and 0p myWaitrose offer

Paging

First public window only, up to 48 organic products; source total can be larger

Availability

Public online ordering control; store stock and slot-specific availability are unmeasured

What people build with Waitrose UK Groceries

The jobs this data is most often used for.

4

endpoints

1/3

credits per call

01

Pricing teams use Waitrose UK Groceries to search the first public UK grocery result window.

02

Marketplace operators use Waitrose UK Groceries to get first public window of a groceries category path..

03

Catalog enrichment teams use Waitrose UK Groceries to get public regular offers or the public My Waitrose Offers list.

04

Retail analysts use Waitrose UK Groceries to get full public product detail.

What Waitrose UK Groceries data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 438 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/waitrose/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milk","limit":12}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/waitrose/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "milk",
  "limit": 12
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Waitrose UK Groceries.

Get a free key →
What is the Waitrose UK Groceries API?▾

Waitrose UK Groceries API is a ReefAPI endpoint group for waitrose uk groceries It returns live JSON through POST requests under /waitrose/v1.

Is the Waitrose UK Groceries API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Waitrose UK Groceries calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Waitrose UK Groceries login or account?▾

No login to Waitrose UK Groceries is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Waitrose UK Groceries data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Waitrose UK Groceries API use?▾

Waitrose UK Groceries actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Waitrose UK Groceries from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call waitrose actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Waitrose UK Groceries API a Waitrose UK Groceries scraper?▾

It is the managed alternative to a DIY Waitrose UK Groceries scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same waitrose uk groceries back as clean JSON.

Why does my Waitrose UK Groceries scraper keep getting blocked?▾

Most Waitrose UK Groceries scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 437 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-02.