Metro & Super C API

Metro and Super C grocery prices, store by store

median response
2.1s
endpoints
4
credits per call
2–3
Measured on live customer calls,

The Metro & Super C API returns grocery prices from metro.ca and superc.ca as clean JSON, per store.

POST/metro-ca/v1/search
Real result, captured Nov 6, 20263 of 50
titlepricebrandpackage_size
2% Lactose-Free Protein Milk9.29 CADNatrel2 L
3.25% Lactose-Free Protein Milk9.29 CADNatrel2 L
1% Lactose-Free Chocolate Protein Milk9.29 CADNatrel2 L
4 active endpoints, on 2 and 3 credit tiers.stores · search · product · categoryDetails ↓OpenAPI 3.0 spec ↗

3 credits per call≈ $3/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.

Metro & Super C API

3 of 4 endpoints, ready to run

View docs ↗

A search on one store's shelf: products with the price there now, regular and sale price, unit prices and whether the row is sponsored.

3 credits2 required · 2 optional
POST/metro-ca/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 Metro & Super C endpoints does ReefAPI ship?

4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • stores

    2 cr

    The stores of one banner with their store_id (for every other action).

    required
    —
    optional
    banner, store_id, postal_code, city, lat, lon, limit
  • search

    3 cr

    Search one Metro or Super C store's shelf.

    required
    query, store_id
    optional
    banner, page
  • product

    3 cr

    One product at one store by its product code (4023, 4688, 061328801366 …) or its page URL.

    required
    product_id, store_id
    optional
    banner
  • category

    3 cr

    Every product of one aisle at one store, paged, with the same rows as search.

    required
    category, store_id
    optional
    banner, page

Every parameter, every allowed value →

Missing a Metro & Super C endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Metro & Super C API works

Metro & Super C 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 632 engines.

Call02
POST /metro-ca/v1/…

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

Pay03
2 or 3 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

Follow one product across Metro and Super C stores

Find store numbers once, then read the same product at each store.

01stores
POST/metro-ca/v1/stores
{"banner": "superc", "postal_code": "G6W"}

The stores near a postal code, each with the number the other calls take.

02product
POST/metro-ca/v1/product
{"product_id": "055872025019", "banner": "metro", "store_id": "82"}

The price of 2 L of milk at one store, with unit price and sale end date if it is on sale.

03product
POST/metro-ca/v1/product
{"product_id": "055872025019", "banner": "superc", "store_id": "6131"}

The same product code at a Super C, on that store's shelf.

A per-store price list for the products you care about, across both banners.

request
curl -X POST https://api.reefapi.com/metro-ca/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milk","banner":"metro","store_id":"82"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "metro-ca",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

The same 2 L of milk at three stores

Québon 2% milk, product code 055872025019, read through product on 2026-11-08 at two Metro stores and a Super C. The prices are what each store's page printed.

StoreBannerprice (CAD)per 100 ml
Metro store 82, Lévismetro4.600.23
Metro store 6, Sainte-Anne-des-Montsmetro4.720.24
Super C store 6131, St-Romualdsuperc4.600.23

Prices are per store and can differ within a banner. For weighed items the same call returns per-kg and per-lb prices: red seedless grapes at Super C 6131 read 8.80 per kg and 3.99 per lb that day, with price_basis per_kg. An item the page prints as an average piece has its estimate in estimated_item_price.

Coverage

Prices belong to a store, and each banner has its own stores

Metro and Super C publish grocery prices for the store you select, and those can differ from one store to another. Measured 2026-11-08 on live responses. Some of these lines go against us.

Each response confirms the store

store_confirmed was true on every call: the data comes from the store you asked for, by its number, and store numbers are specific to a banner.

Three ways an item is sold

price_basis is per_item, per_kg or estimated_item. Grapes at one Super C read 8.80 per kg and 3.99 per lb; an estimated item carries its printed estimate in estimated_item_price.

Against us: sale dates

sale_valid_to is only on product, not in search rows, so read product when the end date matters.

Against us: stock

The site publishes no stock level. stock_status is only 'unavailable' when the site marks an item inactive, and null otherwise.

Sponsored rows

Search rows the site sponsors are marked with sponsored, and sponsored_rows counts them, so you can leave them out of a price comparison.

Not published

A flyer action, product text in French, and any statement of whether the online price equals the shelf price.

Use cases

What people build with Metro & Super C

The jobs this data is most often used for.

01

Compare one basket across Metro and Super C stores in a region

02

Follow a product's price at several stores, in dollars and per kilo

03

Find a store's sale end dates for the items you watch

04

List stores near a postal code with address and today's hours

4

endpoints

2/3

credits per call

Pricing

What Metro & Super C data costs

The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,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 632 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/metro-ca/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milk","banner":"metro","store_id":"82"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/metro-ca/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "milk",
        "banner": "metro",
        "store_id": "82"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Metro & Super C.

How do I find store numbers?▾

stores returns them for a banner, by postal code or its first three characters, by city, or by coordinates with lat and lon. Store numbers are per banner, so a Metro number does not work as a Super C number.

Do prices really differ from store to store?▾

They can. 2 L of Québon 2% milk read 4.60 at one Metro store and 4.72 at another on 2026-11-08, and 4.60 at a Super C. You always read a single store's price, so store_id is required.

How do weighed products come back?▾

price_basis tells you. per_kg means price is the price for price_quantity, usually 1000 g, with price_per_kg and price_per_lb beside it. estimated_item means the page prints an average piece price, returned in estimated_item_price, while the real price depends on the weight.

When does a sale end?▾

product returns sale_valid_to. Search and category rows show on_sale and sale_price but no end date, so call product when the date matters.

Is there a stock level or a flyer endpoint?▾

No stock level: the site publishes none, and stock_status is only 'unavailable' when the site marks an item inactive. There is no flyer action, though search and category rows flag on_sale, and sponsored rows are marked with sponsored.

Does it cover Québec and Ontario, in French?▾

The engine covers Metro and Super C stores in Québec and Ontario, which you list through stores. Product text comes back in English; there is no French parameter on this API.

What is the Metro & Super C API?▾

Metro & Super C API is a ReefAPI endpoint group for store-level grocery prices from metro and super c in québec and ontario: the price at the store you pick, sale end dates and per-kg prices. It returns live JSON through POST requests under /metro-ca/v1.

Is the Metro & Super C API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Metro & Super C calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Metro & Super C login or account?▾

No login to Metro & Super C 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 Metro & Super C data?▾

The page example is captured from a live stores call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Metro & Super C API use?▾

Metro & Super C 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 Metro & Super C from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call metro-ca actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Metro & Super C API a Metro & Super C scraper?▾

It is the managed alternative to a DIY Metro & Super C 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 store-level grocery prices from metro and super c in québec and ontario: the price at the store you pick, sale end dates and per-kg prices back as clean JSON.

Why does my Metro & Super C scraper keep getting blocked?▾

Most Metro & Super C 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.

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 631 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-08.