Zehrs API

Every Zehrs price, deal and stock level, store by store

endpoints
5
credits per call
1–2

The Zehrs API returns grocery data from zehrs.ca, Ontario, as JSON, one store at a time, because Zehrs prices every product per store: on 2026-11-22 Grass Fed 2% Milk was $6.49 on sale at Zehrs Welland and $7.49 at a Fortinos in Hamilton.

/zehrs/v1

  • POST/zehrs/v1/search2 credits
  • POST/zehrs/v1/category2 credits
  • POST/zehrs/v1/deals2 credits
  • POST/zehrs/v1/product1 credit
  • POST/zehrs/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.

Zehrs API

4 of 5 endpoints, ready to run

View docs ↗

Milk prices at Zehrs Laurentian, Kitchener

2 credits1 required · 1 optional
POST/zehrs/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 Zehrs 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 Zehrs store's shelf (zehrs.ca, Ontario, 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 Zehrs store, paged, with th…

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

    2 cr

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

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

    1 cr

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

    required
    product_id
    optional
    store_id, date, language
  • stores

    2 cr

    The 42 Zehrs stores (Ontario) 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 Zehrs endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Zehrs API works

Zehrs 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 /zehrs/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 Zehrs

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 Zehrs; calls to POST /loblaws/v1/... with banner=zehrs keep working unchanged.

01stores?city=Kitchener
GET/zehrs/v1/stores?city=Kitchener

The 4 Kitchener Zehrs stores with their store_id, address, coordinates, hours and phone.

02search?query=milk&store_id=0560
GET/zehrs/v1/search?query=milk&store_id=0560

That store's products with price, was-price, unit price, deal, multi-buy, PC Optimum offer, stock and a sponsored flag, plus brand and deal facets.

03product?product_id=20188873_EA&store_id=0560
GET/zehrs/v1/product?product_id=20188873_EA&store_id=0560

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

04deals?deal=pc_points&store_id=0560
GET/zehrs/v1/deals?deal=pc_points&store_id=0560

Every PC Optimum points offer at that store right now.

A store-specific Zehrs price and deal feed with unit prices and product facts.

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

What a Zehrs field actually contains

Fields that read differently from how they look. Every example was read from live zehrs.ca responses on 2026-11-22.

FieldWhat it holds
store_id, store_defaultedThe Zehrs store the prices belong to, a 4-digit number with its leading zero (0560 Laurentian, Kitchener; 0540 Fairview, Brantford). store_defaulted is true when you did not pass one; the answer then names Zehrs Welland (0550).
price, original_price, discount_amountThe shelf price at that store in CAD, and the was-price and saving printed next to a sale price: Grass Fed 2% Milk $6.49, was $7.49, save $1.00.
multi_buyThe bulk price apart from the single price: Evaporated Milk $2.49, multi_buy "$1.75 MIN 4" = $1.75 each when you buy 4.
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.

Zehrs 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 Zehrs store's.

Coverage

Zehrs coverage, measured

Every number below was read from live zehrs.ca responses on 2026-11-22: the full store list, searches, an aisle, deal lists and products, plus 11 calls (8 of them repeating real customer requests) run through both this API and /loblaws-api with banner=zehrs, which returned the same status and error codes 11 of 11 times and identical store lists and product records.

Stores

42 Zehrs stores, all in Ontario and all selling online: 4 each in Guelph, Kitchener and Barrie, 3 each in Waterloo and Cambridge.

Store matters

The same morning Neilson 2% Milk 4 L was $6.44 at Zehrs Welland (0550) and $6.49 at Fortinos Hamilton Upper James; Grass Fed 2% Milk was $6.49 (was $7.49) at that Zehrs and $7.49 (was $7.99) at that Fortinos.

Catalogue

"milk" found 138 products at Zehrs Welland (53 rows on page 1, 8 of them sponsored; prices $1.77 to $14.49); the Milk & Cream aisle 209 products.

Deals

3,525 products on sale and 3,668 in the site's Multi-Buy list at Zehrs Welland. Multi-buys come apart from the price (Evaporated Milk $2.49, "$1.75 MIN 4"), PC Optimum offers as points (2% Partly Skimmed Milk $5.00, was $7.49, plus "1,000 PC Optimum Points").

Product record

Neilson 2% Milk 4 L came back with 24 of 40 fields filled: $6.44 regular price, GTIN 00066800000152, taxes, ingredients, nutrition table, breadcrumb and images.

Speed

About 1.1 to 1.5 s per search or deals page, 0.7 s per product call, 0.5 to 0.8 s for the 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 Zehrs

The jobs this data is most often used for.

01

Compare Zehrs prices between Ontario stores and against Fortinos, No Frills and Loblaws.

02

Track weekly sale, multi-buy and PC Optimum points deals at the Zehrs stores 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 Zehrs 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/zehrs/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milk","store_id":"0560"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

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

Have a question? We got answers.

The questions people actually ask before wiring up Zehrs.

Is there a Zehrs API?▾

Yes. This API reads Zehrs's online grocery shop live and returns store-by-store prices, deals, product records and the store list as JSON. Nothing needs a Zehrs 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 stores are covered?▾

All 42 Zehrs stores on the site on 2026-11-22, every one in Ontario and every one selling online: 4 each in Guelph, Kitchener and Barrie, 3 each in Waterloo and Cambridge, and more.

Does it return PC Optimum offers?▾

Yes, as points, never as a price: 3 of the 53 "milk" rows at Zehrs Welland carried one ("1,000 PC Optimum Points" on a 2% milk at $5.00, was $7.49). deals with deal=pc_points lists every points offer at a store.

How is this different from the Loblaws API?▾

It is the same data as /loblaws-api with the banner fixed to Zehrs, so you never pass banner. Product ids are shared by all Loblaw banners, prices are not. Existing calls to POST /loblaws/v1/... with banner=zehrs 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 Zehrs API?▾

Zehrs API is a ReefAPI endpoint group for ontario grocery prices per zehrs store: cad price, was-price, unit price, sale and multi-buy deals, pc optimum offers, stock, product facts and the 42-store directory. It returns live JSON through POST requests under /zehrs/v1.

Is the Zehrs API free to try?▾

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

Do I need a Zehrs login or account?▾

No login to Zehrs 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 Zehrs 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 Zehrs API use?▾

Zehrs 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 Zehrs from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call zehrs 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.