NZ Price Monitor | $1.70/1K product checks avatar

NZ Price Monitor | $1.70/1K product checks

Pricing

from $1.36 / 1,000 product checks

Go to Apify Store
NZ Price Monitor | $1.70/1K product checks

NZ Price Monitor | $1.70/1K product checks

NZ grocery price monitor for Woolworths NZ, PAK'nSAVE, New World, Four Square, FreshChoice and SuperValue: watch products by name, barcode or URL, get one price snapshot per run, price history, and drop, threshold and back-in-stock alerts by webhook or email.

Pricing

from $1.36 / 1,000 product checks

Rating

0.0

(0)

Developer

architek.earth

architek.earth

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

2 days ago

Last modified

Categories

Features

Limited permissions

Share

NZ Grocery Price Monitor API — Price History, Matching, Alerts

Free tier: watch up to 10 products weekly across all six New Zealand chains, 4 runs per account, never charged. Paid monitoring costs $0.0017 per product found at a chain, so 100 products checked daily at all six chains costs about $25 a month.

Recorded run: 120 product checks from 20 products in 76 seconds (2026-11-15, build 0.1.2, run GQUfg3EPomPB3kGLu). 99 of 120 matched; a bounded weekly-basket sample.

architek.earth — an independent data studio. Pay-per-result scrapers with recorded runs, published canaries and stable schemas, built for people and AI agents.

Watch a list of groceries at Woolworths NZ, PAK'nSAVE, New World, Four Square, FreshChoice and SuperValue. Each run saves one price snapshot per product and chain, keeps the history in your account, and raises alerts when a price drops, crosses your threshold or comes back in stock.

✅ Why choose this scraper

Six chains, one list

Give products by name ("anchor blue milk 2l"), barcode or product URL. Each run checks every product at every chain you pick and returns one row per product and chain.

Matching you can audit

Barcodes match first. Otherwise names and pack sizes are compared and every match carries a confidence score and matchMethod. Different pack sizes (1L vs 2L, 3 x 420g vs 420g) and different variants (Diet, Decaf, Unsalted) are not accepted as matches. Anything below your threshold comes back as unmatched with its best candidates, never silently dropped.

History and alerts without a database

Snapshots accumulate in a named dataset in your account, one per watchlist. Each row carries previousPrice and change. Alerts compare against the previous run: price drop of at least X%, price at or below a threshold, back in stock. Alerts land in the dataset and, if you want, at a webhook or an email address.

You pay for prices found, nothing else

One charge per product found at a chain. Unmatched products, a chain whose source failed, and free-tier runs cost nothing. A run with a failed source is marked PARTIAL and says which chain.

⚠️ Worth knowing up front

  • Four Square lists weekly specials only. It has no online catalogue, so a product matches there only in a week it is on special (3 of 20 in the recorded basket).
  • SuperValue covers one store. Only SuperValue Milton has an online catalogue.
  • Each chain is checked at one store per run (defaults: PAK'nSAVE Royal Oak, New World Thorndon, Four Square Ohope Beach, FreshChoice Queenstown, SuperValue Milton; Woolworths NZ prices are national online prices). Set stores to choose others.
  • Generic names ("potatoes", "sliced ham") match the closest product a chain sells. For precise tracking give brand and size ("pics peanut butter 380g") or a barcode.
  • Prices are the online shelf prices each site shows. Club and loyalty prices are reported in promo where the source gives them, never in price.
  • One run takes about one to three minutes for 20 products; larger lists take longer. Schedule it yourself (daily or weekly) or use the example tasks.
  • A run that stops early writes one free status row ("recordType": "status") that says why. RUN_SUMMARY records every source run, its cost and the history dataset ID.

⚡ Try the example

Turn on freeTier, paste a list and start the run:

{
"products": ["anchor blue milk 2l", "tip top bread white", "mainland butter 500g", "weet-bix 750g", "chelsea white sugar 1.5kg"],
"watchlistName": "my-basket",
"freeTier": true
}

Example task: weekly basket across NZ chains

Twenty everyday products, all six chains, weekly. Schedule it on Monday mornings and compare price and unitPrice by item across chains.

{
"products": ["anchor blue milk 2l", "tip top bread white", "mainland butter 500g", "eggs 12 pack", "bananas", "weet-bix 750g", "flour 1.5kg", "chelsea white sugar 1.5kg", "watties baked beans 420g", "pics peanut butter", "coca-cola 1.5l", "bell tea bags", "nescafe classic coffee", "long grain rice 1kg", "spaghetti 500g", "cheddar cheese 1kg", "frozen peas 1kg", "sliced ham", "apples", "potatoes"],
"watchlistName": "weekly-basket",
"frequency": "weekly",
"freeTier": false
}

Example task: daily drop alerts on my 25 products

Your own 25 products, daily, with a 10% drop alert and a webhook.

{
"products": [{"name": "anchor blue milk 2l", "maxPrice": 4.5}, {"barcode": "9415007012345"}, "mainland butter 500g"],
"watchlistName": "my-25",
"frequency": "daily",
"dropPercent": 10,
"backInStock": true,
"webhookUrl": "https://example.com/price-alerts",
"freeTier": false
}

⚙️ Input

ParameterTypeDefaultDescription
productsarrayprefilled basketUp to 500. A name, or {"name", "barcode", "url", "size", "maxPrice"}.
watchlistNamestringmy-watchlistNames the history dataset and comparison store. Keep it the same across runs.
chainsarrayall sixwoolworths-nz, paknsave, new-world, foursquare, freshchoice, supervalue.
storesobject{}Store per chain, for example {"new-world": "New World Queenstown", "freshchoice": "papamoa"}.
frequencyselectweeklyweekly or daily; the free tier is weekly.
dropPercentinteger10Alert on a drop of at least this percent since the previous run. 0 turns it off.
priceAtOrBelownumbernoneAlert when a price crosses to this level or lower. Per-product maxPrice overrides it.
backInStockbooleantrueAlert when a product that was unavailable or unmatched is found again.
freeTierbooleanfalse (pre-selected in the form)Up to 10 products, weekly, 4 runs per account, never charged.
webhookUrlstringnoneAlerts are POSTed here as JSON.
notificationEmailstringnoneAlerts are emailed here.
matchThresholdnumber0.6Name and size matches below this confidence are reported as unmatched.
candidatesPerProductinteger5Search results considered per product and chain.
feedbackstringnoneOptional note for the maintainers. Read by a human; never changes output.

🧱 Stable fields

Fields are only ever added, never renamed or removed.

FieldTypeMeaning
recordTypestringsnapshot, alert or status.
watchIdstringStable ID of the watched product.
itemstringThe product as you wrote it.
chainstringChain key, for example paknsave.
chainLabelstringChain name.
statusstringmatched, unmatched or source_failed.
confidencenumber1.0 for barcode or URL matches; otherwise the name and size score.
matchMethodstringbarcode, url or name+size.
productNamestringThe chain's product name.
sizestringThe chain's pack size.
pricenumberShelf price in NZD.
unitPricenumberUnit price in NZD, where published.
unitLabelstringUnit basis, for example 1L or per 100g.
wasPricenumberPrice before a special, where published.
promostringSpecial, club price or promotion note.
inStockbooleanWhere the chain publishes stock.
previousPricenumberPrice in the previous run, when both matched.
changenumberprice - previousPrice.
productChangedbooleanTrue when a different product matched than last run; no comparison or price alert is made.
urlstringProduct page.
storestringStore the price applies to.
reasonstringWhy a row is unmatched, failed or partial.
observedAtstringISO timestamp of the run.
rule, messagestringOn alert rows: price_drop, price_at_or_below or back_in_stock, and a readable message.

📦 Output example

A matched row from run GQUfg3EPomPB3kGLu:

{
"recordType": "snapshot",
"item": "chelsea white sugar 1.5kg",
"chain": "paknsave",
"chainLabel": "PAK'nSAVE",
"status": "matched",
"confidence": 1.0,
"matchMethod": "name+size",
"productName": "White Sugar",
"size": "1.5kg",
"price": 3.29,
"url": "https://www.paknsave.co.nz/shop/product/...",
"observedAt": "2026-11-15T06:16:23+00:00"
}

An unmatched row keeps its candidates:

{"recordType": "snapshot", "item": "anchor blue milk 2l", "chain": "foursquare", "status": "unmatched", "reason": "best candidate below 0.6 (Four Square lists weekly specials only)", "candidates": [{"name": "Pineapples", "price": 4.99, "confidence": 0.0}]}

🧠 Advanced usage

Price history for one product

Open the historyDatasetId from RUN_SUMMARY (dataset nz-price-monitor-<watchlistName> in your storage) and filter by watchId and chain.

Cheapest chain per product

Within one run, group snapshot rows by item and take the lowest unitPrice (or price) among matched rows.

Precise matching

Give barcodes where you have them, or a product URL from one chain plus a name. Raise matchThreshold to 0.8 to accept only close name and size matches.

🔌 Integrations

Snapshots and alerts are a standard dataset: download JSON, CSV or Excel, read them over the API, or trigger your own process from the webhook. A schedule makes the monitor hands-off.

💸 Pricing

EventPriceWhen
Product check$0.0017One watched product found and priced at one chain in one run.

100 products checked daily at six chains: about 495 matched checks per run, about $0.84 per run, about $25 a month. 25 products daily: about $6 a month. Unmatched products, failed sources, status rows and free-tier runs are free.

Store discounts

The primary product-check event keeps its full price for Free and Bronze users. Silver users receive 10% off; Gold, Platinum and Diamond users receive 20% off. Other event prices and free-preview limits are unchanged. The price applied to your run is shown in the Console.

❓ FAQ

Why did a product not match at a chain?

Either the chain does not sell it, the closest product is a different size or variant, or (Four Square) it is not on special this week. The row lists the best candidates so you can refine the name.

Can I watch AU supermarkets?

Not yet. The monitor reads each chain through a source adapter, so Australian chains can be added without changing how matching, history or alerts work.

Can an AI assistant run this?

Yes. AI assistants and agents can start it through the Apify API with the JSON input above and read the snapshot and alert rows back; the stable fields and free status rows are designed for that.

🤖 For AI agents & LLM apps

Use the published input schema to provide a watchlist and a persistent state key. Inspect match confidence and source status before acting on a price alert. Keep the same state key on recurring runs to compare prices with the previous snapshot.

🧰 More from architek.earth

New Zealand prices: Woolworths NZ, PAK'nSAVE, New World, Four Square, FreshChoice, SuperValue, NZ Price Monitor (this actor).

architek.earth · code like concrete

Questions or a product that will not match: open an issue on this page or use the feedback input. This monitor reads publicly available prices only, uses no login or account, and is not affiliated with the retailers.

architek.earth

📝 Changelog

  • 2026-11-16 — Support approved primary-event Store discount tiers; retain exact event checks and existing preview limits.

  • 2026-11-15 — 0.1 first release. Six NZ chains, barcode and name+size matching, history, drop, threshold and back-in-stock alerts, webhook and email delivery.