Loblaws API & Scraper
Loblaw Companies runs eleven grocery banners on one online platform, and every price on it belongs to one store: the same 4 L of Neilson milk was $4.98 on sale at one Loblaws and $7.09 at another on the same day.
🤖 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.
Every call therefore reads one store, chosen with store_id (without it the banner's default store is used and the answer says so). `search` returns the products for a search term with price, was-price, unit price, member price, sale or multi-buy deal, PC Optimum offer flag, stock level, brand, pack size and a sponsored flag, plus the brand, category and deal facets. `category` lists a category, `deals` lists everything on sale, on a multi-buy, on a PC Optimum points offer or in this week's flyer at a store, and `product` returns one product with its price type and end date, every unit price, PC Optimum points, all promotions, taxes, GTIN, ingredients and the nutrition table, for today or a day in the coming week. `stores` gives every store of a banner with its id, address, coordinates, hours and phone.
What a Loblaws field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-10-15.
| Field | What it holds |
|---|---|
| store_id, store_defaulted | The store the prices belong to. Neilson 2% milk 4 L: $4.98 (sale) at Loblaws store 1032, $7.09 at Loblaws store 1424. Carnation evaporated milk: $1.74 at a Superstore, $2.99 at a Loblaws. "milk" counted 136 products at one store and 122 at another. store_defaulted is true when you did not pass a store. |
| price, price_display, price_is_estimate | The shelf price at that store in Canadian dollars. Products sold by weight (bananas, meat) show "about $2.25": an estimate for one average piece, so price_is_estimate is true and the real price per kg and per lb is in unit_prices. |
| original_price, discount_amount | The was-price printed next to a sale price, and the saving. The search row and the product record can print different was-prices for the same item (the row said $7.18, the product record's regular price was $7.09), so each is returned as printed. |
| unit_price, unit_prices | The comparison price the shelf label shows, for example $0.53 per 100 ml, or both $1.96 per kg and $0.89 per lb for produce. |
| deal, multi_buy | deal is the store's own deal badge (sale, multi, limit) with its text and end date. multi_buy is the bulk price apart from the single price: "$2.50 MIN 4" means $2.50 each when you buy 4, while price stays $2.75. |
| member_price | A PC Optimum member-only price, apart from the price everyone pays ("$6.00 Member Price" next to "$7.00 Non-Members"). |
| pc_optimum_offer, pc_optimum_points | A PC Optimum loyalty offer on the product. These are points, never a price: one baby-food pouch carried a 10,000-point offer while its price stayed $2.29. |
| stock_status | in_stock, low_stock or out_of_stock at that store, as the site labels it. |
| sponsored | true for paid placements. On the first page they come on top of the 48 normal rows (8 of 56 rows for "milk"). |
| price_date | The store-calendar day the price is for (Toronto time). product accepts a date up to 6 days ahead, so you can read next week's flyer price: Neilson milk was $4.98 on 14 October and $7.09 from 15 October. |
Search is semantic: a word the site does not know still returns the products closest to it, with the site's own result count. Check the titles before trusting an unusual search.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/loblaws/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk",
"banner": "loblaw",
"store_id": "1032"
}
}{
"ok": true,
"meta": {
"api": "loblaws",
"endpoint": "search",
"mode": "live",
"latency_ms": 1676.8,
"record_count": 53,
"bytes": 166909,
"cache_hit": false,
"total": 150,
"store_id": "1032",
"upstream_requests": 1,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "8d4845ee3eff4fae",
"queue_ms": 1.5,
"fetched_at": "2026-10-18T11:42:01.512Z"
},
"data": {
"query": "milk",
"banner": "loblaw",
"store_id": "1032",
"store_name": null,
"store_defaulted": false,
"sort": "relevance",
"page": 1,
"page_size": 48,
"total": 150,
"returned": 53,
"organic_rows": 45,
"sponsored_rows": 8,
"has_next": true,
"results": [
{
"product_id": "20264273_EA",
"article_number": "20264273",
"title": "Almond Breeze, Unsweetened Vanilla",
"brand": "Blue Diamond",
"package_size": "946 ml",
"package_sizing_text": "946 ml, $0.35/100ml",
"price": 3.29,
"price_display": "$3.29",
"price_is_estimate": false,
"currency": "CAD",
"original_price": null,
"discount_amount": null,
"unit_price": 0.35,
"unit_price_per": "100ml",
"unit_prices": [
{
"price": "[trimmed-depth]",
"per_quantity": "[trimmed-depth]",
"per_unit": "[trimmed-depth]"
}
],
"sold_by": "piece",
"sold_by_source": "SOLD_BY_EACH",
"member_price": null,
"member_price_display": null,
"deal": null,
"multi_buy": null,
"pc_optimum_offer": false,
"pc_optimum_offer_text": null,
"stock_status": "in_stock",
"max_order_quantity": 24,
"environmental_fee": null,
"badge": "Sponsored",
"sponsored": true,
"image": "https://digital.loblaws.ca/PCX/20264273_EA/en/1/20264273_en_front_800.png",
"url": "https://www.loblaws.ca/en/almond-breeze-unsweetened-vanilla/p/20264273_EA",
"rank": 1,
"repeated_in_results": false
},
{
"product_id": "20188873_EA",
"article_number": "20188873",
"title": "2% Milk",
"brand": "Neilson",
"package_size": "4 l",
"package_sizing_text": "4 l, $0.16/100ml",
"price": 6.44,
"price_display": "$6.44",
"price_is_estimate": false,
"currency": "CAD",
"original_price": null,
"discount_amount": null,
"unit_price": 0.16,
"unit_price_per": "100ml",
"unit_prices": [
{
"price": "[trimmed-depth]",
"per_quantity": "[trimmed-depth]",
"per_unit": "[trimmed-depth]"
}
],
"sold_by": "piece",
"sold_by_source": "SOLD_BY_EACH",
"member_price": null,
"member_price_display": null,
"deal": null,
"multi_buy": null,
"pc_optimum_offer": false,
"pc_optimum_offer_text": null,
"stock_status": "in_stock",
"max_order_quantity": 24,
"environmental_fee": null,
"badge": "Prepared in Canada",
"sponsored": false,
"image": "https://digital.loblaws.ca/PCX/20188873_EA/en/1/20188873_en_front_800.png",
"url": "https://www.loblaws.ca/en/2-milk/p/20188873_EA",
"rank": 2,
"repeated_in_results": false
},
{
"product_id": "21731288_EA",
"article_number": "21731288",
"title": "Protein 18g, Lactose-Free, Regular Flavour",
"brand": "Silk",
"package_size": "1.42 l",
"package_sizing_text": "1.42 l, $0.53/100ml",
"price": 7.49,
"price_display": "$7.49",
"price_is_estimate": false,
"currency": "CAD",
"original_price": null,
"discount_amount": null,
"unit_price": 0.53,
"unit_price_per": "100ml",
"unit_prices": [
{
"price": "[trimmed-depth]",
"per_quantity": "[trimmed-depth]",
"per_unit": "[trimmed-depth]"
}
],
"sold_by": "piece",
"sold_by_source": "SOLD_BY_EACH",
"member_price": null,
"member_price_display": null,
"deal": null,
"multi_buy": null,
"pc_optimum_offer": false,
"pc_optimum_offer_text": null,
"stock_status": "in_stock",
"max_order_quantity": 25,
"environmental_fee": null,
"badge": "Sponsored",
"sponsored": true,
"image": "https://digital.loblaws.ca/PCX/21731288_EA/en/1/21731288_en_front_v1_800.png",
"url": "https://www.loblaws.ca/en/protein-18g-lactose-free-regular-flavour/p/21731288_EA",
"rank": 3,
"repeated_in_results": false
}
],
"facets": {
"categories": [
{
"code": "27985",
"name": "Food",
"count": 146
},
{
"code": "59630",
"name": "Health & Wellness",
"count": 4
}
],
"brands": [
{
"code": "BDIA",
"name": "Blue Diamond",
"count": 7
},
{
"code": "CADB",
"name": "Cadbury",
"count": 2
},
{
"code": "CARN",
"name": "Carnation",
"count": 2
}
],
"deals": [
{
"code": "Multi-Buy",
"name": "Multi-Buy",
"count": 18
},
{
"code": "Price Reduction",
"name": "Price Reduction",
"count": 16
},
{
"code": "$1,$2,$3,$4,$5",
"name": "$1,$2,$3,$4,$5",
"count": 6
}
],
"flyers": [
{
"code": "FLYER_ITEM",
"name": "Flyer Item",
"count": 14
}
]
}
}
}What the Loblaws API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search one Loblaw-banner store's shelf: price, was-price, unit price, member price, sale / multi-buy deal, PC Optimum offer flag, stock level, brand, pack size and a sponsored flag per row, plus the brand / category / deal facets. Prices are the chosen store's (`store_id`; without it the banner's default store, flagged). | Pricing teams call search to search one Loblaw-banner store's shelf. | query, banner, store_id, page, page_size, ... |
| category | Every product in one category (department, aisle or shelf) at one store, paged, with the same rows, sorts and filters as search. | Marketplace operators call category to get every product in one category (department, aisle or shelf) at one store, paged, with the same…. | category_id, banner, store_id, page, page_size, ... |
| deals | Everything on one kind of deal at one store right now — sale prices, multi-buys, PC Optimum points offers, $1-$5 deals or this week's flyer — optionally inside one category. | Catalog enrichment teams call deals to get everything on one kind of deal at one store right now. | deal, banner, store_id, category_id, page, ... |
| product | One product at one store by the `product_id` a search row returns (or its product URL): price and price type (regular / special) with its end date, was-price, every unit price, member price, deal and multi-buy price, PC Optimum points offer, all promotions, stock, taxes, deposit, GTIN, description, ingredients, nutrition table, breadcrumb, variants and images. `date` reads the price for a coming day (the store's flyer changes on Thursdays). | Retail analysts call product to get one product at one store by the `product_id` a search row. | product_id, banner, store_id, date, language |
| stores | The stores of one banner with their store_id (for every other action): name, address, postal code, coordinates, phone, today's hours and open-now, minimum online order, departments. Narrow by `postal_code` prefix, `city`, or sort by distance from `lat`+`lon`. | Pricing teams call stores to get the stores of one banner with their store_id (for every other action). | banner, postal_code, city, lat, lon, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/loblaws/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","banner":"loblaw","store_id":"1032"}'import requests
r = requests.post(
"https://api.reefapi.com/loblaws/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"banner": "loblaw",
"store_id": "1032"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/loblaws/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk",
"banner": "loblaw",
"store_id": "1032"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.loblaws.search with {"query":"milk","banner":"loblaw","store_id":"1032"}.Who uses this API and why
- Compare grocery prices for the same product across Loblaws, Superstore, No Frills and other banners, store by store.
- Track weekly flyer, multi-buy and PC Optimum points deals at the stores you watch.
- Monitor price per 100 g / per kg and was-prices for a category to spot real discounts.
- Build a Canadian grocery product database with GTIN, ingredients and nutrition tables.
- Map every store of a banner with coordinates, hours and phone numbers.
Questions developers ask before integrating
Do I need a Loblaws or PC Optimum account?
No. Everything is read logged out: the prices, deals and stock any visitor sees after picking that store. Personal PC Optimum offers that need a login are not included.
Which stores and banners are covered?
Loblaws, Real Canadian Superstore, No Frills, Zehrs, Fortinos, Maxi, Your Independent Grocer, Atlantic Superstore, Wholesale Club, Valu-mart and Dominion: every store that sells online on the site. On 2026-10-15 that was 47 Loblaws stores, 119 Superstores, 310 No Frills and 121 Maxi stores among others. Provigo is not on this platform.
Why does the price depend on the store?
Because Loblaw prices, deals, stock and even the range are set per store. Pass the store_id from the stores call; without it the banner's default store is used and the answer says which.
Can I get French product names?
Yes: product takes language=fr, and searches at Quebec banners such as Maxi return the French catalogue ("lait" at a Maxi store returned titles such as "Crème à cuisson 15 %").
How many products per page?
48 normal rows per page by default (up to 96), plus sponsored rows on page 1. Up to 50 pages; past the last page the answer is an empty page with a note.
Which filters and sorts work?
Sort by relevance, price low to high, price high to low, name or newest; filter by brand code, category and deal type (sale, multi-buy, PC Optimum points, $1-$5 deals, flyer). Each was checked against the unfiltered count: "milk" 136, on sale 29, multi-buy 15, flyer 19, one brand 6.
Can I see next week's flyer prices?
For one product at a time, yes: product with a date up to 6 days ahead returns the price the store will charge that day. Search and deals always show today's prices.
How fresh is the data?
Every call reads the site live; nothing is cached. Deals change on the weekly flyer cycle and stock moves during the day.
What is the Loblaws API?
Loblaws API is a ReefAPI endpoint group for store-by-store grocery prices, deals, pc optimum offers and stock from loblaws, superstore, no frills and eight more canadian banners. It returns live JSON through POST requests under /loblaws/v1.
Is the Loblaws API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Loblaws calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Loblaws login or account?
No login to Loblaws 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 Loblaws 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 Loblaws API use?
Loblaws actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Loblaws from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call loblaws actions with the same key, credit pool and JSON envelope used by normal REST requests.