Reef AI: ask for any data. Try it
Maxi API

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

Maxi API

4 of 5 endpoints, ready to run

View docs ↗

Lait prices at a Maxi in Lévis

2 credits1 required · 1 optional
POST/maxi/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 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.

5 endpoints

search

2 cr

Search one Maxi store's shelf (maxi.ca, Québec, 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 Maxi store, paged, with the…

required
category_id
optional
store_id, page, page_size, sort, brand, deal

deals

2 cr

Everything on one kind of deal at one Maxi store right now.

required
—
optional
deal, store_id, category_id, page, page_size, sort

product

1 cr

One product at one Maxi store by the product_id a search row returns (or its maxi.ca URL).

required
product_id
optional
store_id, date, language

stores

2 cr

The 199 Maxi stores (Québec and 2 in New Brunswick) with their store_id for every other action.

required
—
optional
postal_code, city, lat, lon, sells_online, limit

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

How the Maxi API works

Maxi is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

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

02
Call
POST /maxi/v1/…

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

03
Pay
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.

04
Read
{ ok, data, meta, error }

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

Recipe

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.

01stores?postal_code=G6V
GET/maxi/v1/stores?postal_code=G6V

Maxi stores in that area (Lévis) with their store_id, address, coordinates, hours and phone.

02search?query=lait&store_id=8939
GET/maxi/v1/search?query=lait&store_id=8939

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.

03product?product_id=20040246_EA&store_id=8939&language=fr
GET/maxi/v1/product?product_id=20040246_EA&store_id=8939&language=fr

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

04deals?deal=price_reduction&store_id=8939
GET/maxi/v1/deals?deal=price_reduction&store_id=8939

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.

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

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.

FieldWhat it holds
store_id, store_defaultedThe 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_amountThe 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_displayA 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, languageSearch 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_expiresThe end of a special price on the product record: 2026-12-02 for the Purfiltre sale.
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.

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.

Coverage

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.

Stores

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.

Store matters

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

Catalogue

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

French

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

Deals

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

Product record

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.

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. Search rows are in English; only product returns French texts.

Use cases

What people build with Maxi

The jobs this data is most often used for.

5

endpoints

1/2

credits per call

01

Compare Maxi prices between Québec stores and against other Loblaw banners.

02

Track weekly sale, flyer, member-price and PC Optimum points deals at the Maxi stores you watch.

03

Build a bilingual Québec grocery product database with GTIN, ingredients and nutrition tables.

04

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

Pricing

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.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 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/maxi/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"lait","store_id":"8939"}'
python
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"])
FAQ

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.

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.