Iceland UK groceries API & Scraper
Iceland UK groceries API returns live Iceland UK groceries data as clean JSON for iceland uk groceries The primary endpoint, search, returns products with shelf/unit prices, promotions and availability; source total, facets and paging metadata.
🤖 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.
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 Iceland 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, bonus/benefits. 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/iceland/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk",
"brand": "Iceland",
"page_size": 12
}
}{
"ok": true,
"meta": {
"api": "iceland",
"endpoint": "search",
"mode": "live",
"latency_ms": 7758.5,
"record_count": 12,
"bytes": 2179620,
"cache_hit": false,
"upstream_requests": 3,
"warnings": [
"Unknown parameter: include_pii"
],
"charged_credits": 3,
"version": "1.0.0",
"request_id": "51c06ab53aa242a5",
"queue_ms": 8
},
"data": {
"products": [
{
"id": "19492",
"title": "Iceland British Semi-Skimmed Milk 2 Litres",
"brand": "Iceland",
"url": "https://www.iceland.co.uk/p/iceland-british-semi-skimmed-milk-2-litres-2l/19492.html",
"currency": "GBP",
"price_gbp": 1.65,
"base_price_gbp": 1.65,
"was_price_gbp": null,
"unit_price_gbp": 0.83,
"unit_price_basis": "1l",
"unit_price_text": "£0.83",
"availability": "in_stock",
"availability_scope": "anonymous UK online catalogue; not store stock",
"promotions": [
{
"id": "[trimmed-depth]",
"type": "[trimmed-depth]",
"text": "[trimmed-depth]",
"customer_groups": "[trimmed-depth]",
"coupon_codes": "[trimmed-depth]",
"eligibility": "[trimmed-depth]",
"start_date": "[trimmed-depth]",
"end_date": "[trimmed-depth]",
"required_quantity": "[trimmed-depth]",
"group_quantities": "[trimmed-depth]",
"group_number": "[trimmed-depth]",
"is_meal_deal": "[trimmed-depth]",
"promotion_price_gbp": "[trimmed-depth]",
"multibuy_unit_price_gbp": "[trimmed-depth]",
"unit_price_text": "[trimmed-depth]"
}
],
"categories": {
"0": "Fresh",
"1": "Fresh > Milk, Butter & Eggs",
"2": "Fresh > Milk, Butter & Eggs > Milk"
},
"primary_category_id": "CHLMLKSEM",
"images": [
"http://assets.iceland.co.uk/i/iceland/iceland_british_semi-skimmed_milk_2_litres_2l_19492.jpg"
],
"pack": {},
"rating": 4.7,
"review_count": 452
},
{
"id": "19489",
"title": "Iceland British Whole Milk 2 Litres",
"brand": "Iceland",
"url": "https://www.iceland.co.uk/p/iceland-british-whole-milk-2-litres/19489.html",
"currency": "GBP",
"price_gbp": 1.65,
"base_price_gbp": 1.65,
"was_price_gbp": null,
"unit_price_gbp": 0.83,
"unit_price_basis": "1l",
"unit_price_text": "£0.83",
"availability": "in_stock",
"availability_scope": "anonymous UK online catalogue; not store stock",
"promotions": [
{
"id": "[trimmed-depth]",
"type": "[trimmed-depth]",
"text": "[trimmed-depth]",
"customer_groups": "[trimmed-depth]",
"coupon_codes": "[trimmed-depth]",
"eligibility": "[trimmed-depth]",
"start_date": "[trimmed-depth]",
"end_date": "[trimmed-depth]",
"required_quantity": "[trimmed-depth]",
"group_quantities": "[trimmed-depth]",
"group_number": "[trimmed-depth]",
"is_meal_deal": "[trimmed-depth]",
"promotion_price_gbp": "[trimmed-depth]",
"multibuy_unit_price_gbp": "[trimmed-depth]",
"unit_price_text": "[trimmed-depth]"
}
],
"categories": {
"0": "Fresh",
"1": "Fresh > Milk, Butter & Eggs",
"2": "Fresh > Milk, Butter & Eggs > Milk",
"3": "Fresh > Milk, Butter & Eggs > Milk > Whole Milk"
},
"primary_category_id": "CHLMLKSEM",
"images": [
"http://assets.iceland.co.uk/i/iceland/iceland_british_whole_milk_2_litres_19489.jpg"
],
"pack": {},
"rating": 4.6,
"review_count": 239
},
{
"id": "19502",
"title": "Iceland Scottish Semi-Skimmed Milk 2 Litres",
"brand": "Iceland",
"url": "https://www.iceland.co.uk/p/iceland-scottish-semi-skimmed-milk-2-litres-2l/19502.html",
"currency": "GBP",
"price_gbp": 1.65,
"base_price_gbp": 1.65,
"was_price_gbp": null,
"unit_price_gbp": 0.83,
"unit_price_basis": "1l",
"unit_price_text": "£0.83",
"availability": "in_stock",
"availability_scope": "anonymous UK online catalogue; not store stock",
"promotions": [
{
"id": "[trimmed-depth]",
"type": "[trimmed-depth]",
"text": "[trimmed-depth]",
"customer_groups": "[trimmed-depth]",
"coupon_codes": "[trimmed-depth]",
"eligibility": "[trimmed-depth]",
"start_date": "[trimmed-depth]",
"end_date": "[trimmed-depth]",
"required_quantity": "[trimmed-depth]",
"group_quantities": "[trimmed-depth]",
"group_number": "[trimmed-depth]",
"is_meal_deal": "[trimmed-depth]",
"promotion_price_gbp": "[trimmed-depth]",
"multibuy_unit_price_gbp": "[trimmed-depth]",
"unit_price_text": "[trimmed-depth]"
}
],
"categories": {
"0": "Fresh",
"1": "Fresh > Milk, Butter & Eggs",
"2": "Fresh > Milk, Butter & Eggs > Milk",
"3": "Fresh > Milk, Butter & Eggs > Milk > Skimmed Milk"
},
"primary_category_id": "CHLMLKSEM",
"images": [
"http://assets.iceland.co.uk/i/iceland/iceland_scottish_semi-skimmed_milk_2_litres_2l_19502.jpg"
],
"pack": {},
"rating": 4.8,
"review_count": 69
}
],
"total": 19,
"total_exhaustive": true,
"page": 1,
"page_size": 12,
"last_page": 2,
"has_more": true,
"page_clamped": false,
"facets": {
"brand": {
"Iceland": 19
},
"filterType": {
"Semi Skimmed Milk": 2,
"Whole Milk": 1
},
"priceRange": {
"£1.00 - £2.00": 11,
"£2.00 - £3.00": 5,
"£0.00 - £1.00": 3
},
"buyingGroup": {
"Milk": 15,
"Ice Cream": 3
},
"filterBrand": {
"Iceland": 16
},
"categoryPageId": {
"MEALTIME": 16,
"BREAKCLB": 15,
"BREAKCLBCEREL": 15,
"CHL": 15,
"CHLMLK": 15,
"CHLMLKSEM": 15,
"EDE": 14,
"CHLMLKSKIM": 9,
"MEALPL": 9,
"PCDAY": 8,
"PCDAYING": 8,
"PRO": 8,
"PROCHL": 8,
"DIWALI": 6,
"CHLMLKWHO": 5,
"ICECAM": 5,
"ICEOWNLABEL": 5,
"EID": 4,
"FRZ": 4,
"FRZDES": 4,
"INEANT": 4,
"INSPIRRAMADAN": 4,
"TRESNA": 4,
"1POUVAL": 3,
"1POUVALFRE": 3,
"1POUVALFRE-3": 3,
"2BRANDVAL": 3,
"BYG": 3,
"FRZDESDEF": 3,
"FRZDESSTI": 3,
"ICE1FREE": 3,
"LDN": 3,
"LDNES": 3,
"RECIHOTCHOC": 3,
"RECINS": 3,
"SEASONAL": 3,
"1POUVALDRK-3": 2,
"BESTSELL": 2,
"BIGBRANDSLOWPRICES": 2,
"BULK": 2,
"BULKESS": 2,
"CAM5STORE": 2,
"CHLMLKSEMI": 2,
"COROESS": 2,
"EIDFEAST": 2,
"ESSICE": 2,
"FRZDESMAJ": 2,
"LONDONBYG": 2,
"OFFPPC": 2,
"PROCHLPC": 2,
"RECIPANCAKE": 2,
"SAVESSENTIAL": 2,
"SWISAVE": 2,
"2BRANDVALFRZ": 1,
"AFBLOG": 1,
"AFCHOCBPUD": 1,
"BCEMAIL": 1,
"BEKREC": 1,
"BEKRECOVO": 1,
"BTSLUNCHBOX": 1,
"BYGCR2": 1,
"CAMICECREAM": 1,
"CAMSCOT": 1,
"CORESS": 1,
"COROFAV": 1,
"DRIDES": 1,
"FRZDESLOL": 1,
"FWHRegion2": 1,
"JUBI": 1,
"JUBIMINSCO": 1,
"JUBIREC": 1,
"MANAGERSPECIAL": 1,
"OFFEM": 1,
"PARTY": 1,
"PARTYESS": 1,
"PARTYRECIPE": 1,
"PARTYRECIPERAIN": 1,
"RECINSITACLA": 1,
"RECINSITACLALAS": 1,
"RECIPANCK": 1,
"RECIPES": 1,
"TOPRTD": 1,
"WBDN": 1
},
"buyingSubGroup1": {
"Semi Skimmed": 7,
"Whole Milk": 6,
"Ice cream sticks": 2,
"Skimmed Milk": 2,
"Ice Lollies": 1
},
"buyingSubGroup2": {
"Almond and chocolate ice cream": 1,
"Chocolate ice cream": 1,
"Milk ice lolly": 1
},
"primary_category_id": {
"CHLMLKSEM": 14,
"FRZDESDEF": 2,
"1POUVAL": 1,
"FRZDESLOL": 1,
"FRZDESSTI": 1
},
"__primary_category.0": {
"Fresh": 14,
"Frozen": 4,
"£1 or Less": 1
},
"__primary_category.1": {
"Fresh > Milk, Butter & Eggs": 14,
"Frozen > Ice Cream & Lollies": 4,
"£1 or Less > £1 Value Fresh": 1
},
"__primary_category.2": {
"Fresh > Milk, Butter & Eggs > Milk": 14,
"Frozen > Ice Cream & Lollies > Ice Cream Cones, Sticks & Bars": 2,
"Frozen > Ice Cream & Lollies > Ice Cream Sticks & Bars": 1,
"Frozen > Ice Cream & Lollies > Ice Lollies": 1
}
},
"currency": "GBP"
}
}What the Iceland UK groceries API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search UK groceries. Supply query or category; anonymous online catalogue prices in GBP. | Pricing teams call search to search UK groceries. | query, category, brand, availability, promotion_id, ... |
| product/detail | Full public product page and label sheet, resolved from the retailer product id. | Marketplace operators call product/detail to get full public product page and label sheet, resolved from the retailer product id.. | product_id |
| bonus/benefits | Public Bonus Club benefits and terms. Reward credit is separate from product member pricing. | Catalog enrichment teams call bonus/benefits to get public Bonus Club benefits and terms. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/iceland/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","brand":"Iceland","page_size":12}'import requests
r = requests.post(
"https://api.reefapi.com/iceland/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"brand": "Iceland",
"page_size": 12
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/iceland/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk",
"brand": "Iceland",
"page_size": 12
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.iceland.search with {"query":"milk","brand":"Iceland","page_size":12}.Who uses this API and why
- Pricing teams use Iceland UK groceries to search UK groceries.
- Marketplace operators use Iceland UK groceries to get full public product page and label sheet, resolved from the retailer product id..
- Catalog enrichment teams use Iceland UK groceries to get public Bonus Club benefits and terms.
Questions developers ask before integrating
What is the Iceland UK groceries API?
Iceland UK groceries API is a ReefAPI endpoint group for iceland uk groceries It returns live JSON through POST requests under /iceland/v1.
Is the Iceland UK groceries API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Iceland UK groceries calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Iceland UK groceries login or account?
No login to Iceland 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 Iceland 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 Iceland UK groceries API use?
Iceland 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 Iceland UK groceries from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call iceland actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Iceland UK groceries API an Iceland UK groceries scraper?
It is the managed alternative to a DIY Iceland 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 iceland uk groceries back as clean JSON.
Why does my Iceland UK groceries scraper keep getting blocked?
Most Iceland 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.