Every Maxi price, deal and stock level in Québec, store by store
The Maxi API returns grocery data from maxi.ca, Loblaw's discount banner in Québec, as JSON, one store at a time, because Maxi prices, deals and stock are set per store.
- endpoints
- 5
- credits per call
- 1–2
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
5 active endpoints, on 1 and 2 credit tiers.
- POST/maxi/v1/search2 credits
- POST/maxi/v1/category2 credits
- POST/maxi/v1/deals2 credits
- POST/maxi/v1/product1 credit
- POST/maxi/v1/stores2 credits
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.
Maxi API
4 of 5 endpoints, ready to run
Lait prices at a Maxi in Lévis
// 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 Maxi endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Maxi endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Maxi API works
Maxi 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 postal code to a priced basket at the nearest Maxi
Find the store, search its shelf, then read the products that matter, in French if you need it. It is the same data as /loblaws-api with the banner fixed to Maxi; calls to POST /loblaws/v1/... with banner=maxi keep working unchanged.
Maxi stores in that area (Lévis) with their store_id, address, coordinates, hours and phone.
That store's products with price, was-price, unit price, deal, member price, PC Optimum flag, stock and a sponsored flag, plus brand and deal facets.
The full record at that store in French: price type and end date, taxes, GTIN, ingredients and nutrition.
Everything on sale at that store right now.
A store-specific Québec grocery price and deal feed for Maxi with unit prices and bilingual product facts.
curl -X POST https://api.reefapi.com/maxi/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lait","store_id":"8939"}'{
"ok": true,
"data": { … },
"meta": {
"api": "maxi",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Maxi field actually contains
Fields that read differently from how they look. Every example was read from live maxi.ca responses on 2026-11-22.
| Field | What it holds |
|---|---|
| store_id, store_defaulted | The Maxi store the prices belong to (8939 Lévis Président-Kennedy, 7225 Lévis Guillaume-Couture). store_defaulted is true when you did not pass one; the answer then names Maxi Québec Les Saules (8049). |
| 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: Purfiltre 2% 4 L $8.50, was $9.49, save $0.99. |
| member_price, member_price_display | A member-only price, apart from the price everyone pays: a Dairy Milk almond bar "$3.00 Non-Members", member_price 2.25 ("$2.25 Member Price"). |
| title, language | Search rows are in English. product with language=fr returns the French title, description, deal text and badges as the site prints them in French ("0,99 $ DE RABAIS"). |
| price_expires | The end of a special price on the product record: 2026-12-02 for the Purfiltre sale. |
| 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. |
Maxi 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 Maxi store's.
Maxi coverage, measured
Every number below was read from live maxi.ca responses on 2026-11-22: the full store list, searches, an aisle, deal lists and products in English and French, plus 12 calls (7 of them repeating real customer requests) run through both this API and /loblaws-api with banner=maxi, which returned the same status and error codes 12 of 12 times and identical store lists and product records.
199 Maxi stores, 197 in Québec and 2 in New Brunswick; 120 of them sell online (14 of the 18 in Montréal). Québec City, Gatineau and Sherbrooke have 5 to 6 stores each.
Purfiltre 2% milk 4 L was on sale at $8.50 (was $9.49, until 2 December) at Maxi Québec Les Saules (8049); a Dairy Milk almond bar there was $3.00 for non-members and $2.25 for members, while a Real Canadian Superstore sold it at $3.49 with "2 FOR $6.00".
"lait" found 181 products at Maxi Québec Les Saules (50 rows on page 1, 8 of them sponsored; prices $1.50 to $11.50); the Milk & Cream aisle 218 products. Search accepts French and English words; the row titles come in English.
product with language=fr returns the French texts: "Purfiltre. lait partiellement écrémé 2 %", deal "0,99 $ DE RABAIS", badge "Préparé au Québec".
3,163 products on sale and 111 in the site's Multi-Buy list at Maxi Québec Les Saules; member-only prices kept apart ("$2.25 Member Price" next to "$3.00 Non-Members").
Purfiltre Partially Skimmed Milk 2% came back with 28 of 40 fields filled: price, price type and end date, was-price, saving, GTIN 00068200010144, taxes, ingredients, nutrition table, breadcrumb and images.
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. Search rows are in English; only product returns French texts.
What people build with Maxi
The jobs this data is most often used for.
endpoints
credits per call
Compare Maxi prices between Québec stores and against other Loblaw banners.
Track weekly sale, flyer, member-price and PC Optimum points deals at the Maxi stores you watch.
Build a bilingual Québec grocery product database with GTIN, ingredients and nutrition tables.
Monitor price per 100 ml or per kg and was-prices to spot real discounts.
What Maxi 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/maxi/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lait","store_id":"8939"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/maxi/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "lait",
"store_id": "8939"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Maxi.
Is there a Maxi API?▾
Yes. This API reads Maxi's online grocery shop live and returns store-by-store prices, deals, product records and the store list as JSON. Nothing needs a Maxi 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".
Can I get French product names?▾
Yes, on the product call: language=fr returns the French title, description, deal text and badges ("Purfiltre. lait partiellement écrémé 2 %", "Préparé au Québec"). Search accepts French words such as lait, pain or beurre, but its rows come in English.
Does it cover every Maxi store?▾
Every store on the site: 199 on 2026-11-22, 197 in Québec and 2 in New Brunswick. 120 sell online and are listed by default; sells_online=false lists all of them.
Does it return member prices?▾
Yes, apart from the price: a Dairy Milk almond bar showed $3.00 for non-members and $2.25 as the member price at Maxi Québec Les Saules on 2026-11-22.
How is this different from the Loblaws API?▾
It is the same data as /loblaws-api with the banner fixed to Maxi, so you never pass banner. Product ids are shared by all Loblaw banners, prices are not. Existing calls to POST /loblaws/v1/... with banner=maxi 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 Maxi API?▾
Maxi API is a ReefAPI endpoint group for québec grocery prices per maxi store: cad price, was-price, unit price, sale and multi-buy deals, pc optimum offers, stock, product facts in english or french and the 199-store directory. It returns live JSON through POST requests under /maxi/v1.
Is the Maxi API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Maxi calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Maxi login or account?▾
No login to Maxi 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 Maxi 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 Maxi API use?▾
Maxi actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
390 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Maxi, 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.