New World NZ Scraper — Store Prices, Clubcard, Specials

Recorded 17 Oct 2026: the same products priced at four New World stores (Wellington, Auckland, Queenstown) — 38 of the 39 products stocked by all four had a different price somewhere. A 750 g Weet-Bix was $6.99 at Thorndon and Queenstown and $7.89 at Metro Willis St.

From Architekture, makers of the Pak'nSave NZ, Woolworths NZ, Woolworths AU, Coles AU, ALDI AU, Tesco UK and Sainsbury's UK scrapers.

New World stores are individually owned and set their own prices. This actor returns New World products store by store: shelf price, Clubcard price, unit price, promotions, category and link, for one store, a handful, or all of them (about 150 online stores). Search by keyword or browse whole categories. Optional product details add the barcode (EAN), ingredients, allergens, nutrition and image. No New World account needed.

Why choose this actor

• Prices for the store you name. Every row carries storeId, storeName and storeRegion; ask for ["Thorndon", "Queenstown"] and you get each store's own price side by side. "all" covers every online New World store.
• Clubcard price, separately. price is the shelf price; clubPrice (and clubPricePerUnit) appears when the product has a Clubcard-only price at that store. Multi-buys stay in promotions — never passed off as a single-item price.
• Unit pricing as New World shows it. pricePerUnit with pricePerUnitLabel (e.g. 1L, 1kg) for like-for-like comparison.
• Barcodes for joins. With includeDetails: true, barcode (EAN-13) lets you join New World against Pak'nSave, Woolworths NZ or your own catalogue.
• Clean stops and fair billing. A run that finds nothing costs nothing; hitting your spending limit or the run timeout ends with a summary and everything collected so far.

Worth knowing up front

• New World is behind Cloudflare. Each run starts a real browser on a New Zealand residential IP to get an anonymous shop session (about 15–25 seconds), then reads New World's own product API. That warm-up is why there is a per-run fee (below). Residential NZ proxy is required and is the default.
• Prices are online-shop prices for the chosen store. They match what newworld.co.nz shows for that store; in-store shelf tickets can differ on the day.
• No stock levels. New World publishes which channels sell a product (availabilityChannels: IN_STORE, ONLINE), not how many are on the shelf. Nobody can return stock counts from the public site.
• Search depth: 50 products per page, at most 1,000 per search per store (New World's search limit).
• No account features. No order history, no personalised prices, no "bought before" flags — this actor never logs in.

Try the example

{
  "searchTerms": ["milk"],
  "stores": ["New World Thorndon", "New World Queenstown"],
  "maxItemsPerQuery": 20
}

40 rows (20 per store) in about a minute: $0.15 run fee + 40 × $0.004 = $0.31.

Input parameters

Parameter	Type	Default	Description
searchTerms	array of strings	—	Keywords, up to 50 per run.
categories	array of strings	—	Category name (Pantry), path (pantry/baking-supplies-and-sugar) or URL (https://www.newworld.co.nz/shop/category/pantry). Matched against each store's own category tree.
stores	array of strings	["New World Thorndon"]	Store names (the "New World" part is optional), store ids, or "all". A name that matches several stores (e.g. Metro) is rejected with the matches listed.
maxItemsPerQuery	integer	100	Products per search (or category) per store. 0 = everything listed, up to 1,000.
includeDetails	boolean	false	Adds barcode, description, ingredients, allergens, nutrition, imageUrl. One extra request per product: slower, same price per product.
proxyConfiguration	object	RESIDENTIAL, NZ	Leave as is; other proxies are not tested.
feedback	string	—	A note to the maintainers. Read by a human; does not change output.

Use searchTerms, categories, or both. Each store × search pair is one search; a run takes up to 600.

Stable fields for automations

These keep their names and meaning across versions; new fields are only added. A field is omitted (not null) when New World does not publish it for that product.

Field	Meaning
id	New World product id, e.g. 5201479-EA-000. Unique per store per run.
name	Product name.
brand	Brand.
packageSize	Size as shown, e.g. 2l, 500g.
price	Shelf (non-Clubcard) price at this store, NZD.
clubPrice	Clubcard-only single-item price at this store, NZD, when there is one.
clubPricePerUnit	Unit price at the Clubcard price.
pricePerUnit	Unit price at the shelf price, NZD.
pricePerUnitLabel	Unit for pricePerUnit, e.g. 1L, 1kg.
isOnPromotion	true when New World lists any promotion for it at this store.
promotions	Offers as published: type, value (NZD), quantity (2 = "2 for"), clubcardOnly.
saleType	How New World sells it, e.g. UNITS (per item).
availabilityChannels	IN_STORE / ONLINE. Channels, not stock.
category	Department > Aisle > Shelf, e.g. Fridge, Deli & Eggs > Milk > Fresh Milk.
isLiquor, isRestricted	Age-restricted product flags.
url	Product page on newworld.co.nz.
storeId, storeName, storeRegion	The store these prices belong to.
position	Rank in that store's results (1 = first).
source	{source: "search", query, page} or {source: "category", category, page}.
barcode, description, ingredients, allergens, nutrition, imageUrl	With includeDetails only.

Output example

{
  "id": "5227964-EA-000",
  "name": "Protein Fix Iced Chocolate Flavoured Milk",
  "brand": "Mammoth Supply Co.",
  "packageSize": "600ml",
  "price": 5.99,
  "pricePerUnit": 9.98,
  "pricePerUnitLabel": "1L",
  "clubPrice": 5.49,
  "clubPricePerUnit": 9.15,
  "isOnPromotion": true,
  "promotions": [{ "promoId": "130442327", "type": "NEW_PRICE", "value": 5.49, "quantity": 1, "clubcardOnly": true }],
  "saleType": "UNITS",
  "availabilityChannels": ["IN_STORE", "ONLINE"],
  "category": "Hot & Cold Drinks > Hot Chocolate & Milk Drinks > Flavoured Milk",
  "isLiquor": false,
  "isRestricted": false,
  "url": "https://www.newworld.co.nz/shop/product/5227964_ea_000nw",
  "storeId": "38b074c4-0e5a-4bd5-b743-d30f28d94982",
  "storeName": "New World Metro Willis St",
  "storeRegion": "Wellington",
  "position": 38,
  "source": { "source": "search", "query": "milk", "page": 1 }
}

Advanced usage

• Price map across stores: stores: ["all"], a short searchTerms list, maxItemsPerQuery: 50; pivot on id × storeName.
• Clubcard savings: keep rows with clubPrice; price - clubPrice is the member saving at that store.
• Cross-retailer basket: run with includeDetails: true, then join on barcode with our Pak'nSave NZ and Woolworths NZ actors.
• Daily monitoring: schedule the same stores and terms; compare price/clubPrice per storeId + id day to day.
• Completion check: read RUN_SUMMARY — status (COMPLETE, PARTIAL, BLOCKED, BUDGET_LIMIT, TIME_LIMIT, INVALID_INPUT), products, runFeeCharged, and searches (per store × query: status, delivered, listed, pagesRead).

Integrations

Export as JSON, CSV, Excel or RSS; push to Google Sheets; trigger from Make, Zapier or n8n; webhook on run finish; schedule with the Apify Scheduler.

Pricing

Event	Price	Covers
collection-delivered	$0.15 per run	Once per run, only after the first product is saved. Covers the browser warm-up past Cloudflare.
product	$4.00 / 1,000	One product row (one product at one store) delivered to the dataset.

Platform usage and the residential proxy are included. A run that delivers nothing is not charged at all, and nothing is charged for failed requests or for products the run could not save. Set a maximum charge of at least $0.154 (one fee + one product); lower limits are rejected before the run starts. Examples: 100 products = $0.55; 1,000 = $4.15; 10,000 in one run = $40.15.

FAQ

Do prices really differ between New World stores? Yes. In our 17 Oct 2026 check, 38 of 39 products stocked by four stores had a different price at one or more of them. Two stores can still share prices for many products (two Metro stores matched on every product we checked), so compare the stores you care about.

Is price the Clubcard price? No. price is the price without a Clubcard; clubPrice is the Clubcard-only price when there is one.

Can I get stock levels? No. New World does not publish them; availabilityChannels only says whether a product is sold in store and/or online.

Why a per-run fee? Every run has to start a real browser to get past Cloudflare before it can read a single product. The fee covers that; it is charged once and only when the run delivers products.

How do I find a store's id? Use its name ("Thorndon"), or run once with any store and read stores in RUN_SUMMARY; ids are listed there.

Why did my run end BLOCKED? New World did not issue a shop session after several fresh browsers and IPs. Nothing was charged; rerun later. If it repeats, open an issue — we are alerted on consecutive failures too.

Do I need a New World account? No, and the actor never uses one.

How fast? Measured on live validation runs (2026-10-17): ~10 s browser warm-up, then ~12 products/s sustained — a 2,000-product category run finished in 122 s, and 4,100+ products in under 6 minutes. With includeDetails add a fraction of a second per product.

For AI agents & LLM apps

architekture/new-world-nz-scraper returns New World New Zealand products with each store's own prices — shelf price, clubPrice, unit price, promotions, category, product URL, and the store they belong to — as deterministic, schema-stable JSON, one object per product per store, same fields on every run, so agents and RAG pipelines can parse it without defensive code. Invoke it from any agentic workflow via the Apify API or the Apify MCP server (mcp.apify.com) as a tool call; pay-per-event billing means a run costs a known amount before it starts ($0.15 per productive run + $4 per 1,000 products; maxItemsPerQuery caps it). Each run writes a RUN_SUMMARY record with a machine-readable status and per-store, per-search outcome, so an agent can branch on BLOCKED or BUDGET_LIMIT instead of parsing logs. Honest limits: no stock levels, no account-only data, online-shop prices for the store requested.

More Architekture scrapers

• NZ grocery: New World NZ (you are here) · Pak'nSave NZ · Woolworths NZ
• AU grocery: Woolworths AU · Coles AU · ALDI AU
• UK grocery: Tesco UK · Sainsbury's UK
• E-commerce: AliExpress Search

New World and Pak'nSave run on the same Foodstuffs platform, so their field names match (id, price, pricePerUnit, storeId, promotions); other retailers' fields are similar but not identical.

Support

Open an Issue on this actor's page; a human replies within a day.

Legal compliance

This actor reads publicly available product and price pages, without logging in. You are responsible for how you use the data, including New World's terms of use, intellectual property in product names and images, and data-protection law where it applies.

Changelog

• 2026-10-17 — 1.0: keyword search and category browsing; store-by-store prices for one, several or all New World stores; Clubcard price, unit price and promotions; optional barcode, ingredients, allergens, nutrition and image; de-duplication per store; clean stops at spending limit and timeout; resumable after platform migration.