Real Canadian Superstore API

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
5 active endpoints, on 1 and 2 credit tiers.Every parameter ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run 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

View docs ↗

Milk prices at a Superstore

2 credits1 required · 1 optional
POST/real-canadian-superstore/v1/search
idle
// 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.

Try every endpoint in the playground

Endpoints

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 cr

    Search 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 cr

    Every 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 cr

    Everything 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 cr

    One 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 cr

    The 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 it works

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.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

Call02
POST /real-canadian-superstore/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01stores?city=Calgary
GET/real-canadian-superstore/v1/stores?city=Calgary

The 13 Calgary Superstores with their store_id, address, coordinates, hours and phone.

02search?query=milk&store_id=1562
GET/real-canadian-superstore/v1/search?query=milk&store_id=1562

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.

03product?product_id=20962518_EA&store_id=1562
GET/real-canadian-superstore/v1/product?product_id=20962518_EA&store_id=1562

The full record at that store: price type and end date, deposit, taxes, GTIN, ingredients and nutrition.

04deals?deal=multi_buy&store_id=1562
GET/real-canadian-superstore/v1/deals?deal=multi_buy&store_id=1562

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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "real-canadian-superstore",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
store_id, store_defaultedThe 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_amountThe 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_buydeal 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_feeContainer deposit and environmental fee charged on top of the price: $0.10 deposit on a 4 L Dairyland milk.
price_is_estimatetrue 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_pricesThe comparison price the shelf label shows, for example $0.16 per 100 ml for a 4 L milk.
pc_optimum_offer, pc_optimum_offer_textA PC Optimum loyalty offer on the product ("1,000 PC Optimum Points"). These are points, never a price.
stock_statusin_stock, low_stock or out_of_stock at that store, as the site labels it.
sponsoredtrue 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.

Coverage

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.

Stores

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).

Store matters

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.

Catalogue

"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.

Deals

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.

Product record

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.

Speed

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.

Limits

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.

Use cases

What people build with Real Canadian Superstore

The jobs this data is most often used for.

01

Compare Superstore prices between stores and provinces, and against No Frills, Loblaws and Maxi.

02

Track weekly sale, multi-buy and PC Optimum points deals at the Superstores you watch.

03

Monitor price per 100 ml or per kg and was-prices to spot real discounts.

04

Build a Canadian grocery product database with GTIN, ingredients and nutrition tables.

5

endpoints

1/2

credits per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.