Ocado UK Groceries API & Scraper
Ocado UK Groceries API returns live Ocado UK Groceries data as clean JSON for ocado uk groceries The primary endpoint, search, returns Products with GBP current shelf and unit prices, promotions, availability, facets and next_cursor.
🤖 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.
Search total is unknown except a compl…. 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 Ocado UK Groceries 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/ocado/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk",
"limit": 24
}
}{
"ok": true,
"meta": {
"api": "ocado",
"endpoint": "search",
"mode": "live",
"latency_ms": 1674.6,
"record_count": 22,
"bytes": 584198,
"cache_hit": false,
"upstream_requests": 1,
"warnings": [
"Unknown parameter: include_pii"
],
"charged_credits": 3,
"version": "0.1.0",
"request_id": "7d6d2807dd1e4a4b",
"queue_ms": 1.5
},
"data": {
"products": [
{
"id": "24577011",
"product_id": "8161bfc9-792f-45a1-a50a-6dec88888d6f",
"title": "Cravendale Filtered Fresh Whole Milk Fresher for Longer",
"brand": "Cravendale",
"pack_size": "2L",
"price_gbp": 2.65,
"source_base_price_gbp": 2.65,
"original_price_gbp": null,
"currency": "GBP",
"unit_price_gbp": 1.33,
"unit": "litre",
"promotions": [
{
"id": "[trimmed-depth]",
"description": "[trimmed-depth]",
"terms": "[trimmed-depth]",
"member_only": "[trimmed-depth]",
"multibuy": "[trimmed-depth]",
"required_quantity": "[trimmed-depth]",
"equivalent_price_gbp": "[trimmed-depth]",
"equivalent_unit_price_gbp": "[trimmed-depth]",
"unit": "[trimmed-depth]"
}
],
"available": true,
"in_current_catalog": true,
"category_path": [
"Fresh & Chilled Food",
"Dairy & Eggs",
"Milk"
],
"dietary_labels": [
"Vegetarian",
"Ocado Price Promise"
],
"rating": 4.8,
"review_count": 147,
"guaranteed_product_life": {
"quantity": 2,
"unit": "WEEK"
},
"image": "https://www.ocado.com/images-v3/eafa5127-d256-497b-9609-4869092accd6/8a88d7c1-aff6-4f87-9605-03e4981b61ed/300x300.jpg",
"url": "https://www.ocado.com/products/24577011",
"group_type": "featured"
},
{
"id": "606356011",
"product_id": "d29ba19d-6548-4e7f-b0c4-d0e8b56ec2b0",
"title": "Arla BOB Semi-Skimmed Milk that Tastes like Whole",
"brand": "Arla",
"pack_size": "2L",
"price_gbp": 2.5,
"source_base_price_gbp": 2.5,
"original_price_gbp": null,
"currency": "GBP",
"unit_price_gbp": 1.25,
"unit": "litre",
"promotions": [
{
"id": "[trimmed-depth]",
"description": "[trimmed-depth]",
"terms": "[trimmed-depth]",
"member_only": "[trimmed-depth]",
"multibuy": "[trimmed-depth]",
"required_quantity": "[trimmed-depth]",
"equivalent_price_gbp": "[trimmed-depth]",
"equivalent_unit_price_gbp": "[trimmed-depth]",
"unit": "[trimmed-depth]"
}
],
"available": true,
"in_current_catalog": true,
"category_path": [
"Fresh & Chilled Food",
"Dairy & Eggs",
"Milk"
],
"dietary_labels": [
"Suitable for freezing",
"Vegetarian",
"Microwavable"
],
"rating": 4.5,
"review_count": 117,
"guaranteed_product_life": {
"quantity": 2,
"unit": "WEEK"
},
"image": "https://www.ocado.com/images-v3/eafa5127-d256-497b-9609-4869092accd6/eeab8dca-610d-4f2f-8e42-31e353192a13/300x300.jpg",
"url": "https://www.ocado.com/products/606356011",
"group_type": "featured"
},
{
"id": "274675011",
"product_id": "52813d3f-69da-487f-933d-38e4bc6fdd02",
"title": "Oatly Oat Drink Barista Edition Long Life",
"brand": "Oatly",
"pack_size": "1L",
"price_gbp": 1.5,
"source_base_price_gbp": 2.2,
"original_price_gbp": 2.2,
"currency": "GBP",
"unit_price_gbp": 1.5,
"unit": "litre",
"promotions": [
{
"id": "[trimmed-depth]",
"description": "[trimmed-depth]",
"terms": "[trimmed-depth]",
"member_only": "[trimmed-depth]",
"multibuy": "[trimmed-depth]",
"required_quantity": "[trimmed-depth]",
"equivalent_price_gbp": "[trimmed-depth]",
"equivalent_unit_price_gbp": "[trimmed-depth]",
"unit": "[trimmed-depth]"
}
],
"available": true,
"in_current_catalog": true,
"category_path": [
"Fresh & Chilled Food",
"Dairy & Eggs",
"Milk Alternatives"
],
"dietary_labels": [
"Lactose Free",
"Vegetarian",
"Vegan"
],
"rating": 4.6,
"review_count": 664,
"guaranteed_product_life": null,
"image": "https://www.ocado.com/images-v3/eafa5127-d256-497b-9609-4869092accd6/5aed6f73-69b0-4d89-8e79-a77f0013469a/300x300.jpg",
"url": "https://www.ocado.com/products/274675011",
"group_type": "featured"
}
],
"returned": 22,
"next_cursor": "9d21b032-6e6e-4340-b67e-001f227070d9",
"has_more": true,
"total": null,
"total_basis": "unknown",
"source_category_count": 0,
"category": {
"id": "723d17c1-3312-45fd-b275-7117fad4d1b5",
"name": "Root"
},
"facets": [
{
"filterId": "boolean",
"label": "boolean",
"attributes": [
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
},
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
}
],
"type": "BOOLEAN"
},
{
"filterId": "brands",
"label": "brands",
"attributes": [
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
},
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
},
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
}
],
"type": "BRANDS"
},
{
"filterId": "dietaryAndLifestyle",
"label": "Dietary & Lifestyle",
"attributes": [
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
},
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
},
{
"filterAttributeId": "[trimmed-depth]",
"label": "[trimmed-depth]",
"selected": "[trimmed-depth]"
}
],
"type": "RETAILER"
}
],
"sort_options": [
{
"sortOptionId": "favorite",
"messageKey": "sorting.option.favorite",
"selected": true
},
{
"sortOptionId": "pricePerAscending",
"messageKey": "sorting.option.price.per.ascending",
"selected": false
},
{
"sortOptionId": "pricePerDescending",
"messageKey": "sorting.option.price.per.descending",
"selected": false
}
],
"duplicate_rows_dropped": 1,
"featured_rows": 4
}
}What the Ocado UK Groceries API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search UK groceries. GTIN/EAN is not available on the measured surfaces. | Pricing teams call search to search UK groceries. | query |
| product/detail | Full public product and label sheet, including promotion terms. | Marketplace operators call product/detail to get full public product and label sheet, including promotion terms.. | id |
Call search from your stack
curl -X POST https://api.reefapi.com/ocado/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","limit":24}'import requests
r = requests.post(
"https://api.reefapi.com/ocado/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"limit": 24
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/ocado/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk",
"limit": 24
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.ocado.search with {"query":"milk","limit":24}.Who uses this API and why
- Pricing teams use Ocado UK Groceries to search UK groceries.
- Marketplace operators use Ocado UK Groceries to get full public product and label sheet, including promotion terms..
- Catalog enrichment teams use Ocado UK Groceries 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 Ocado UK Groceries API?
Ocado UK Groceries API is a ReefAPI endpoint group for ocado uk groceries It returns live JSON through POST requests under /ocado/v1.
Is the Ocado UK Groceries API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Ocado UK Groceries calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Ocado UK Groceries login or account?
No login to Ocado 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 Ocado 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 Ocado UK Groceries API use?
Ocado UK Groceries actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Ocado UK Groceries from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call ocado actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Ocado UK Groceries API an Ocado UK Groceries scraper?
It is the managed alternative to a DIY Ocado 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 ocado uk groceries back as clean JSON.
Why does my Ocado UK Groceries scraper keep getting blocked?
Most Ocado 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.