Sainsbury's API & Scraper
Sainsbury's API returns live Sainsbury's data as clean JSON for sainsbury's The primary endpoint, search, returns products[], total, returned, requested_page, page, last_page, page_clamped, has_more and next_page.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Products carry product_uid, URL, EANs…. Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Sainsbury's scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product/detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/sainsburys/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk"
}
}{
"ok": true,
"meta": {
"api": "sainsburys",
"endpoint": "search",
"mode": "live",
"latency_ms": 1520.5,
"record_count": 55,
"bytes": 3437112,
"cache_hit": false,
"warnings": [
"Unsupported parameter ignored: include_pii"
],
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "d84975c090414ac2",
"queue_ms": 1.2
},
"data": {
"products": [
{
"id": "sainsburys-british-semi-skimmed-milk-2-27l-4-pint",
"product_uid": "357937",
"name": "Sainsbury's British Semi Skimmed Milk 2.27L (4 pint)",
"url": "https://www.sainsburys.co.uk/gol-ui/product/sainsburys-british-semi-skimmed-milk-2-27l-4-pint",
"currency": "GBP",
"price_gbp": 1.65,
"nectar_price_gbp": null,
"price_measure": "",
"unit_price": {
"price": 0.73,
"measure": "ltr",
"measure_amount": 1
},
"nectar_unit_price": null,
"is_available": true,
"eans": [
"0000000357937",
"0000050181117"
],
"image": "https://assets.sainsburys-groceries.co.uk/gol/357937/image.jpg",
"promotions": [],
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"reviews": {
"is_enabled": true,
"product_uid": "357937",
"total": 2112,
"average_rating": 4.6051
}
},
{
"id": "sainsburys-british-semi-skimmed-milk-1-13l-2-pint",
"product_uid": "1137637",
"name": "Sainsbury's British Semi Skimmed Milk 1.13L (2 pint)",
"url": "https://www.sainsburys.co.uk/gol-ui/product/sainsburys-british-semi-skimmed-milk-1-13l-2-pint",
"currency": "GBP",
"price_gbp": 1.2,
"nectar_price_gbp": null,
"price_measure": "",
"unit_price": {
"price": 1.06,
"measure": "ltr",
"measure_amount": 1
},
"nectar_unit_price": null,
"is_available": true,
"eans": [
"5000181013566",
"0000001137637"
],
"image": "https://assets.sainsburys-groceries.co.uk/gol/1137637/image.jpg",
"promotions": [],
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"reviews": {
"is_enabled": true,
"product_uid": "1137637",
"total": 2112,
"average_rating": 4.6051
}
},
{
"id": "sainsburys-british-whole-milk-2-27l-4-pint",
"product_uid": "181402",
"name": "Sainsbury's British Whole Milk 2.27L (4 pint)",
"url": "https://www.sainsburys.co.uk/gol-ui/product/sainsburys-british-whole-milk-2-27l-4-pint",
"currency": "GBP",
"price_gbp": 1.65,
"nectar_price_gbp": null,
"price_measure": "",
"unit_price": {
"price": 0.73,
"measure": "ltr",
"measure_amount": 1
},
"nectar_unit_price": null,
"is_available": true,
"eans": [
"0000000487429",
"0000050181100",
"0000000181402"
],
"image": "https://assets.sainsburys-groceries.co.uk/gol/181402/image.jpg",
"promotions": [],
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"reviews": {
"is_enabled": true,
"product_uid": "181402",
"total": 976,
"average_rating": 4.7285
}
}
],
"total": 964,
"returned": 55,
"requested_page": 1,
"page": 1,
"last_page": 17,
"page_clamped": false,
"has_more": true,
"next_page": 2
}
}What the Sainsbury's API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the public UK online grocery assortment by keyword and page. Page size varies; pages above the live ceiling are explicitly clamped to the final page. No unverified source filters. | Pricing teams call search to search the public UK online grocery assortment by keyword and page. | query, country, page |
| product/detail | Read the public product page by the source slug id or URL returned by search. Numeric product_uid is a separate legacy identifier and not a resolver. | Marketplace operators call product/detail to read the public product page by the source slug id or URL returned by search. | id, url, country |
Call search from your stack
curl -X POST https://api.reefapi.com/sainsburys/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk"}'import requests
r = requests.post(
"https://api.reefapi.com/sainsburys/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/sainsburys/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.sainsburys.search with {"query":"milk"}.Who uses this API and why
- Pricing teams use Sainsbury's to search the public UK online grocery assortment by keyword and page.
- Marketplace operators use Sainsbury's to read the public product page by the source slug id or URL returned by search.
- Catalog enrichment teams use Sainsbury's to track product listings, prices, availability, variants and reviews, all from one ReefAPI key and credit pool.
Questions developers ask before integrating
What is the Sainsbury's API?
Sainsbury's API is a ReefAPI endpoint group for sainsbury's It returns live JSON through POST requests under /sainsburys/v1.
Is the Sainsbury's API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Sainsbury's calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Sainsbury's login or account?
No login to Sainsbury's 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 Sainsbury's 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 Sainsbury's API use?
Sainsbury's actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Sainsbury's from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call sainsburys actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Sainsbury's API a Sainsbury's scraper?
It is the managed alternative to a DIY Sainsbury's 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 sainsbury's back as clean JSON.
Why does my Sainsbury's scraper keep getting blocked?
Most Sainsbury's 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.