Every Real Canadian Superstore price, deal and stock level, store by store
- endpoints
- 5
- credits per call
- 1–2
The Real Canadian Superstore API returns grocery data from realcanadiansuperstore.ca as JSON, one store at a time, because every Superstore has its own prices: on 2026-11-22 the same 2% ultrafiltered milk was $4.99 at the Superstore in Prince George and $5.55 at a No Frills in Edmonton.
/real-canadian-superstore/v1
- POST/real-canadian-superstore/v1/search2 credits
- POST/real-canadian-superstore/v1/category2 credits
- POST/real-canadian-superstore/v1/deals2 credits
- POST/real-canadian-superstore/v1/product1 credit
- POST/real-canadian-superstore/v1/stores2 credits
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Real Canadian Superstore API
4 of 5 endpoints, ready to run
Milk prices at a Superstore
// 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.
What Real Canadian Superstore endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
search
2 crSearch one Real Canadian Superstore's shelf (realcanadiansuperstore.ca, Canada, prices in CAD).
- required
- query
- optional
- store_id, page, page_size, sort, brand, deal, category_id
category
2 crEvery product in one category (department, aisle or shelf) at one Real Canadian Superstore, p…
- required
- category_id
- optional
- store_id, page, page_size, sort, brand, deal
deals
2 crEverything on one kind of deal at one Real Canadian Superstore right now.
- required
- —
- optional
- deal, store_id, category_id, page, page_size, sort
product
1 crOne product at one Real Canadian Superstore by the product_id a search row returns (or its re…
- required
- product_id
- optional
- store_id, date, language
stores
2 crThe 119 Real Canadian Superstore stores (Ontario, Alberta, British Columbia, Manitoba, Saskat…
- required
- —
- optional
- postal_code, city, lat, lon, sells_online, limit
Every parameter, every allowed value →
Missing a Real Canadian Superstore endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Real Canadian Superstore API works
Real Canadian Superstore is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a city to a priced basket at the nearest Superstore
Find the store, search its shelf, then read the products that matter. It is the same data as /loblaws-api with the banner fixed to Real Canadian Superstore; calls to POST /loblaws/v1/... with banner=superstore keep working unchanged.
The 13 Calgary Superstores with their store_id, address, coordinates, hours and phone.
That store's products with price, was-price, unit price, deal, multi-buy, PC Optimum flag, stock and a sponsored flag, plus brand and deal facets.
The full record at that store: price type and end date, deposit, taxes, GTIN, ingredients and nutrition.
Everything on a multi-buy at that store right now.
A store-specific Real Canadian Superstore price and deal feed with unit prices and product facts.
curl -X POST https://api.reefapi.com/real-canadian-superstore/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","store_id":"1562"}'{
"ok": true,
"data": { … },
"meta": {
"api": "real-canadian-superstore",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Real Canadian Superstore field actually contains
Fields that read differently from how they look. Every example was read from live realcanadiansuperstore.ca responses on 2026-11-22.
| Field | What it holds |
|---|---|
| store_id, store_defaulted | The Superstore the prices belong to (1517 Vancouver Marine Drive, 1080 Mississauga Argentia Road, 1533 Regina Albert Street). store_defaulted is true when you did not pass one; the answer then names Ferry Avenue, Prince George (1562). |
| price, original_price, discount_amount | The shelf price at that store in CAD, and the was-price and saving printed next to a sale price: Crispy Crunch Milkshake $1.29, was $1.99. |
| deal, multi_buy | deal is the store's own badge (sale, multi, limit) with its text and end date. multi_buy keeps the bulk price apart from the single price: "$2.50 MIN 2" gives price 2.50 and min_quantity 2; "2 FOR $6.00" (a Dairy Milk bar at $3.49) comes as text only, with price and min_quantity null. |
| deposit, environmental_fee | Container deposit and environmental fee charged on top of the price: $0.10 deposit on a 4 L Dairyland milk. |
| price_is_estimate | true for goods sold by weight: the row prints "about $x" for one average piece and the real price per kg and per lb is in unit_prices. |
| unit_price, unit_price_per, unit_prices | The comparison price the shelf label shows, for example $0.16 per 100 ml for a 4 L milk. |
| pc_optimum_offer, pc_optimum_offer_text | A PC Optimum loyalty offer on the product ("1,000 PC Optimum Points"). These are points, never a price. |
| stock_status | in_stock, low_stock or out_of_stock at that store, as the site labels it. |
| sponsored | true for paid placements, mixed into page 1: 8 of the 51 "milk" rows at No Frills Edmonton on 2026-11-22. |
Superstore search is semantic: a word the site does not know still returns the closest products, with the site's own count. Product ids are shared with every Loblaw banner; the price is the Superstore's.
Real Canadian Superstore coverage, measured
Every number below was read from live realcanadiansuperstore.ca responses on 2026-11-22: the full store list, searches, an aisle, deal lists and products, plus 12 calls run through both this API and /loblaws-api with banner=superstore, which returned the same status and error codes 12 of 12 times and identical store lists and product records.
119 Real Canadian Superstore stores, all selling online: 37 in Ontario, 34 in Alberta, 28 in British Columbia, 11 in Manitoba, 8 in Saskatchewan and 1 in Yukon (13 in Calgary, 10 in Edmonton, 8 in Winnipeg).
The same morning, 2% Ultrafiltered Partly Skimmed Milk was $4.99 at the Superstore in Prince George (1562) and $5.55 at No Frills Edmonton; a Dairy Milk almond bar was $3.49 with "2 FOR $6.00" at that Superstore and $3.00 ($2.25 for members) at a Maxi in Québec.
"milk" found 131 products at the Prince George Superstore (53 rows on page 1, 8 of them sponsored; prices $1.99 to $13.29); the Milk & Cream aisle 216 products.
3,966 products on sale and 6,316 in the site's Multi-Buy list at the Prince George store. Multi-buys printed as "$2.50 MIN 2" come with price and minimum quantity; those printed as "2 FOR $6.00" come as text only.
Dairyland 2% Regular Milk 4 L came back with 25 of 40 fields filled: $5.81 regular price, $0.10 deposit, GTIN 00068700011016, taxes, ingredients, nutrition table, breadcrumb and images.
About 0.9 to 1.3 s per search or deals page, 0.75 s per product call, 0.9 s for the full store list.
One store per call; 48 rows per page by default (up to 96; with 96 the site sometimes returns only about 50 rows for the same request), 50 pages; search, category and deals show today's prices; no customer reviews; personal PC Optimum offers that need a login are not included.
What people build with Real Canadian Superstore
The jobs this data is most often used for.
Compare Superstore prices between stores and provinces, and against No Frills, Loblaws and Maxi.
Track weekly sale, multi-buy and PC Optimum points deals at the Superstores you watch.
Monitor price per 100 ml or per kg and was-prices to spot real discounts.
Build a Canadian grocery product database with GTIN, ingredients and nutrition tables.
endpoints
credits per call
What Real Canadian Superstore 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.
- 1,000 free credits on signup, no card
- One key, all 746 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 -X POST https://api.reefapi.com/real-canadian-superstore/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","store_id":"1562"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/real-canadian-superstore/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"store_id": "1562"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Real Canadian Superstore.
Is there a Real Canadian Superstore API?▾
Yes. This API reads Real Canadian Superstore's online grocery shop live and returns store-by-store prices, deals, product records and the store list as JSON. Nothing needs a Real Canadian Superstore or PC Optimum account: everything is read logged out, as any visitor sees it after picking a store.
Why does the price depend on the store?▾
Because Loblaw banners price, stock and range every store separately. Pass the store_id from the stores call; without one the API reads the banner's default store and says so (store_defaulted: true).
Which currency are the prices in?▾
Canadian dollars; every row carries currency "CAD".
Which provinces are covered?▾
Every Superstore on the site: on 2026-11-22 the stores call listed 119 stores, 37 in Ontario, 34 in Alberta, 28 in British Columbia, 11 in Manitoba, 8 in Saskatchewan and 1 in Yukon, all selling online. Atlantic Superstore is a separate banner in /loblaws-api (banner=rass).
Are multi-buy deals returned as prices?▾
Yes when the site prints them as "$2.50 MIN 2" (price 2.50, min_quantity 2). Deals printed as "2 FOR $6.00" are returned as the site's text in multi_buy.text and deal.text, with no computed price.
How is this different from the Loblaws API?▾
It is the same data as /loblaws-api with the banner fixed to Real Canadian Superstore, so you never pass banner. Product ids are shared by all Loblaw banners, prices are not. Existing calls to POST /loblaws/v1/... with banner=superstore keep working unchanged.
How many products per page?▾
48 by default, up to 96, and up to 50 pages; on page 1 the site mixes in sponsored rows (page 1 of "milk" at each banner's default store on 2026-11-22: 50 to 53 rows, 7 or 8 of them sponsored). With 96 the site sometimes answers about 50 rows for the same request, so page with 48 when you need every row.
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 Real Canadian Superstore API?▾
Real Canadian Superstore API is a ReefAPI endpoint group for canadian grocery prices per real canadian superstore: cad price, was-price, unit price, sale and multi-buy deals, pc optimum offers, stock, product facts and the 119-store directory. It returns live JSON through POST requests under /real-canadian-superstore/v1.
Is the Real Canadian Superstore API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Real Canadian Superstore calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Real Canadian Superstore login or account?▾
No login to Real Canadian Superstore 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 Real Canadian Superstore 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 Real Canadian Superstore API use?▾
Real Canadian Superstore 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 Real Canadian Superstore from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call real-canadian-superstore actions with the same key, credit pool and JSON envelope used by normal REST requests.
390 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Real Canadian Superstore, you are one call away from the rest of the category — no second contract, no second integration.
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.
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 745 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-11-22.