Reef AI: ask for any data. Try it
Woolworths NZ API

Woolworths New Zealand prices, specials and member prices, store by store

Woolworths NZ is New Zealand's largest supermarket chain and online grocery shop, the former Countdown, at woolworths.co.nz.

endpoints
8
credits per call
1–2

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

8 active endpoints, on 1 and 2 credit tiers.

  • POST/woolworths-nz/v1/search2 credits
  • POST/woolworths-nz/v1/specials2 credits
  • POST/woolworths-nz/v1/category2 credits
  • POST/woolworths-nz/v1/offer1 credit
  • POST/woolworths-nz/v1/product1 credit
  • POST/woolworths-nz/v1/products2 credits
  • POST/woolworths-nz/v1/categories1 credit
  • POST/woolworths-nz/v1/stores1 credit
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.

Woolworths NZ API

4 of 8 endpoints, ready to run

View docs ↗

Milk prices at Woolworths Queenstown

2 credits1 required · 1 optional
POST/woolworths-nz/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 Woolworths NZ endpoints does ReefAPI ship?

8 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

8 endpoints

search

2 cr

Keyword search of woolworths.co.nz at one store, as the site's search box answers it.

required
query
optional
category, store_id, brand, dietary, min_health_star_rating, in_stock_only, promotion, sort, page, page_size, include_facets

specials

2 cr

The site's Specials & offers pages at one store.

required
—
optional
category, store_id, brand, dietary, min_health_star_rating, in_stock_only, promotion, sort, page, page_size, include_facets

category

2 cr

Browse one department, aisle or shelf of woolworths.co.nz at one store (the site's browse pag…

required
category
optional
store_id, brand, dietary, min_health_star_rating, in_stock_only, promotion, sort, page, page_size, include_facets

offer

1 cr

Every product in one multi-buy offer group ('any 4 for $10.00'), by the offer_number a row's…

required
offer_number
optional
store_id, sort, page, page_size, include_facets

product

1 cr

One product at one store.

required
product_id
optional
store_id

products

2 cr

Up to 100 products by id in ONE request (the site's own by-sku lookup).

required
product_ids
optional
store_id

categories

1 cr

The site's category tree.

required
—
optional
department

stores

1 cr

Woolworths NZ stores and pickup points.

required
—
optional
query, region, latitude, longitude, limit

Every parameter, every allowed value →

Missing a Woolworths NZ endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Woolworths NZ API works

Woolworths NZ 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 750 engines.

02
Call
POST /woolworths-nz/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

A daily Woolworths NZ price feed for one store

Pick the store once, find your products by keyword, then read them by id every day.

01stores?query=Queenstown
GET/woolworths-nz/v1/stores?query=Queenstown

The store_id to pass on every price call (9058 = Queenstown Woolworths); 192 stores and pickup points in all.

02search?query=milk&store_id=9058
GET/woolworths-nz/v1/search?query=milk&store_id=9058

Every match with price, was-price, member price, multi-buy and unit price at that store (174 milk products at Queenstown).

03products?product_ids=282793,133211,99999999
GET/woolworths-nz/v1/products?product_ids=282793,133211,99999999

Up to 100 products in one call, in the order asked; ids the store does not list come back in not_found.

04specials?promotion=specials&category=Fridge%20%26%20Deli%20%3E%20Milk
GET/woolworths-nz/v1/specials?promotion=specials&category=Fridge%20%26%20Deli%20%3E%20Milk

This week's specials in one aisle with was-price and saving.

Store-specific Woolworths NZ shelf prices, specials and member prices for your basket, every day.

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

What a Woolworths NZ field actually contains

Fields that read differently from how they look. Every row was measured against live responses on 2026-11-22.

FieldWhat it holds
priceThe price everybody pays today at the store in store_id, in NZD, specials included. It matched the price on the product's own page for 14 of 14 products checked. For loose produce sold by weight (price_unit "kg") it is the price per kg.
was_price, saved_amount, saved_percentOnly on specials: the price before the special and the saving. So Good Almond Milk 1L read price 3.69, was_price 4.98, saved_percent 25.9. saved_percent is worked out from the two prices because the site's own percentage field is empty. null, not 0, when there is no special.
member_price, member_unit_priceThe Everyday Rewards member price, kept apart from the shelf price: Woolworths Free From Lactose Milk 1L reads price 4.20 and member_price 3.99. Shown on the product page as "Member Price" for 3 of 3 products checked. Only members pay it.
multi_buyA deal on several units, with the group price never divided into price: Vitasoy Oat Milk 1L reads price 3.99 and multi_buy {quantity 4, price 10.00, text "4 for $10.00", unit price $2.50 / 1L, offer_number}. The offer call lists every product the deal covers.
unit_price, unit_price_per_kg, unit_price_per_lThe site's unit price ("$2.79 / 1L", "$1.37 / 100G") plus the same value brought to per kg or per litre so rows compare. Wine carries no unit price on the site (0 of 56 rows).
store_id, store_name, store_defaultedThe store the prices belong to. store_defaulted is true when no store_id was given and the site's default store (9171, Greville Road Woolworths, Auckland) priced the answer.
sponsored, ad_rankThe first page of an unfiltered search carries up to 10 promoted products (ads) on top of the normal results. They are real products with the store's real price and are flagged; the same product can appear again as a normal result on a later page.
promotionsEvery deal tag the site shows on the product: special, percentage off, half price, low price, member price, multi-buy, with its label ("SAVE $1.00", "4 for $6.00") and whether it is members only.
health_star_ratingThe Health Star Rating from 0.5 to 5; null when the product is not rated (wine, nappies).
variantsEvery way the product is sold: loose bananas come as 133211-KG at $3.85 per kg (minimum 0.25 kg) and 133211-EA at $0.96 each.
category_paths, product_groupsOn the product call: the real aisle path ("Fridge & Deli > Milk > Full Cream Milk") apart from the site's own marketing groups the product is placed in.

Woolworths NZ does not publish reviews or ratings, stock counts (only in stock / out of stock), personalised Boost offers (they need a login), or opening hours and coordinates in its store list. One query returns at most its first 1,000 products; narrow with a category or filter for more.

Coverage

Woolworths NZ coverage, measured

Every number below was read from live responses on 2026-11-22: 12 keyword searches across the store, 14 products read from search and on their own and compared with their product pages, 5 stores compared product by product, whole aisles walked page by page and a 24-call load test.

Catalogue

19,078 products at the default store; 8,083 on a promotion (1,912 member prices, 312 multi-buys, 185 half price); 845 departments, aisles and shelves; 192 stores and pickup points.

Price accuracy

Price equal to the product page for 14 of 14 products of every kind (plain, special, member price, multi-buy, sold by weight); was-price shown on the page for 5 of 5, member price for 3 of 3; search row and product record agreed for 14 of 14.

Prices per store

Queenstown differed from Auckland on 41 of 87 milk and 36 of 90 bread products, Invercargill on 37 of 83 milk products; Whangarei and Wellington matched Auckland.

Fields

Price, title, brand, stock state, URL and image on 587 of 587 rows; unit price on 529 of 587 (none on wine); was-price on 169, member price on 56, multi-buy on 21, country of origin on 185 of 587.

Complete lists

Fridge & Deli > Milk: 200 of 200 products; half-price specials: 185 of 185, no product repeated or missing.

Speed

Median 1.6 s, 24 of 24 calls answered with four at a time; first call for a new store up to 5.4 s; 100 products by id in 1.6 s.

Limits

At most the first 1,000 products of one query and 100 per page; promoted products (ads) on page 1 of an unfiltered search are flagged and can repeat later; no reviews, stock counts, Boost offers or store opening hours.

Use cases

What people build with Woolworths NZ

The jobs this data is most often used for.

8

endpoints

1/2

credits per call

01

Compare Woolworths NZ grocery prices with PAK'nSAVE and New World, product by product and store by store.

02

Track specials, was-prices and Everyday Rewards member prices on a basket of products every day.

03

Build a New Zealand food price index from unit prices per kg and per litre across regions.

04

Check which multi-buy deals and half-price specials run at a given Woolworths store this week.

Pricing

What Woolworths NZ 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 750 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/woolworths-nz/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milk"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

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

Have a question? We got answers.

The questions people actually ask before wiring up Woolworths NZ.

Is this Countdown?▾

Yes. Countdown became Woolworths New Zealand; the shop is woolworths.co.nz. This API is the New Zealand shop only. Woolworths Australia (woolworths.com.au) is a separate API.

Do I need a Woolworths account?▾

No. Everything is read logged out: the prices, specials, member prices and multi-buys any visitor sees.

Are prices different per store?▾

Yes. On 2026-11-22, 41 of 87 milk products and 36 of 90 bread products had a different price at Queenstown than in Auckland (Woolworths Milk Standard 2L: $4.85 against $4.71), and 37 of 83 milk products differed at Invercargill. Whangarei and Wellington matched Auckland on the same products. Pass store_id from the stores call; without it the site's default store (Greville Road, Auckland) is used.

Can I see specials and member prices?▾

Yes. Every row carries the was-price and saving when a product is on special, the Everyday Rewards member price apart from the shelf price, and any multi-buy. The specials call lists the site's Specials & offers pages: on 2026-11-22 the default store had 8,083 products on a promotion, 1,912 with a member price, 312 on a multi-buy and 185 at half price.

Which filters and sorts work?▾

Brand, dietary tag (dairy free, gluten free, low salt, low sugar, organic, vegan, vegetarian), minimum health stars, in stock only, category and promotion type; sort by relevance, price or unit price. Each was checked against the unfiltered count: "milk" 194, brand Anchor 26, vegan 38, health stars 4.5 or more 43, Pantry 59, specials 51, member price 23. The site's unit-price sort lists products without a unit price first and mixes units, so compare on unit_price_per_kg or unit_price_per_l.

How do I track prices every day?▾

Keep the product ids you care about and read them with the products call, up to 100 per call: 100 products came back in one call in 1.6 s. Ids the store no longer lists come back in not_found.

How many products can one search return?▾

Up to 100 per page and at most the first 1,000 products of any query, as on the site. A whole aisle walks completely: Fridge & Deli > Milk returned all 200 of 200 products.

How fast is it?▾

Median 1.6 s per call in a 24-call test with four calls at a time, all 24 answered; the first call for a new store takes up to 5.4 s.

What is the Woolworths NZ API?▾

Woolworths NZ API is a ReefAPI endpoint group for woolworths new zealand (woolworths.co.nz, formerly countdown) grocery prices per store: nzd shelf price, specials with was-price, everyday rewards member price, multi-buys, unit price per kg or litre, nutrition and barcodes. It returns live JSON through POST requests under /woolworths-nz/v1.

Is the Woolworths NZ API free to try?▾

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

Do I need a Woolworths NZ login or account?▾

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

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

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