Woolworths NZ
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.
/woolworths-nz/v1/search2 creditsKeyword search of woolworths.co.nz at one store, as the site's search box answers it: NZD shelf price, was-price and saving on specials, Everyday Rewards member price, multi-buy, unit price, stock state per product. Filter by brand, dietary tag, health stars, in-stock, category or promotion; sort by price or unit price.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for, as typed in the site's search box. |
| category | optional | — | A category from the categories action: its key (9-FD6D608D), path ('Fridge & Deli > Milk'), site URL / slug path (fridge-deli/milk) or a unique name. |
| store_id | optional | — | Woolworths store (pickup location) id from the stores action, e.g. 9058 = Queenstown. Prices differ per store; without it the site's default store for a new visitor is used (9171 Greville Road, Auckland; store_defaulted: true). |
| brand | optional | — | One or more brands, as the site lists them in facets.brands (any of them; case-insensitive). |
| dietary | optional | dairy_free · gluten_free · low_salt · low_sugar · organic · vegan · vegetarian | Dietary / allergen tags the site filters on (all of them must apply). |
| min_health_star_rating | optional | 0.5–5 | Only products with at least this health star rating (0.5 steps). |
| in_stock_only = false | optional | — | Only products in stock at the store. |
| promotion | optional | all_promotions · specials · member_price · multibuy · low_price · half_price · online_only_specials | The site's promotion filters (any of them): specials, member_price (Everyday Rewards), multibuy, low_price, half_price, online_only_specials, all_promotions. |
| sort = relevance | optional | relevance · price_asc · price_desc · unit_price_asc | The site's own sorts. Price sorts leave out sponsored-only matches. |
| page = 1 | optional | 1–1000 | 1-based page. The site serves at most 1000 rows per query (page × page_size). |
| page_size = 48 | optional | 1–100 | Rows per page, 1-100 (the site's page is 48). |
| include_facets = true | optional | — | Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions). |
/woolworths-nz/v1/specials2 creditsThe site's Specials & offers pages at one store: every product on a promotion (default all promotions), or only specials, member prices, multi-buys, low price, half price or online-only specials; narrow by category, brand, dietary tag; sort by price.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| promotion | optional | all_promotions · specials · member_price · multibuy · low_price · half_price · online_only_specials | The site's promotion filters (any of them): specials, member_price (Everyday Rewards), multibuy, low_price, half_price, online_only_specials, all_promotions. |
| category | optional | — | A category from the categories action: its key (9-FD6D608D), path ('Fridge & Deli > Milk'), site URL / slug path (fridge-deli/milk) or a unique name. |
| store_id | optional | — | Woolworths store (pickup location) id from the stores action, e.g. 9058 = Queenstown. Prices differ per store; without it the site's default store for a new visitor is used (9171 Greville Road, Auckland; store_defaulted: true). |
| brand | optional | — | One or more brands, as the site lists them in facets.brands (any of them; case-insensitive). |
| dietary | optional | dairy_free · gluten_free · low_salt · low_sugar · organic · vegan · vegetarian | Dietary / allergen tags the site filters on (all of them must apply). |
| min_health_star_rating | optional | 0.5–5 | Only products with at least this health star rating (0.5 steps). |
| in_stock_only = false | optional | — | Only products in stock at the store. |
| sort = relevance | optional | relevance · price_asc · price_desc · unit_price_asc | The site's own sorts. Price sorts leave out sponsored-only matches. |
| page = 1 | optional | 1–1000 | 1-based page. The site serves at most 1000 rows per query (page × page_size). |
| page_size = 48 | optional | 1–100 | Rows per page, 1-100 (the site's page is 48). |
| include_facets = true | optional | — | Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions). |
/woolworths-nz/v1/category2 creditsBrowse one department, aisle or shelf of woolworths.co.nz at one store (the site's browse pages), with the same filters and sorts as search.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | A category from the categories action: its key (9-FD6D608D), path ('Fridge & Deli > Milk'), site URL / slug path (fridge-deli/milk) or a unique name. |
| store_id | optional | — | Woolworths store (pickup location) id from the stores action, e.g. 9058 = Queenstown. Prices differ per store; without it the site's default store for a new visitor is used (9171 Greville Road, Auckland; store_defaulted: true). |
| brand | optional | — | One or more brands, as the site lists them in facets.brands (any of them; case-insensitive). |
| dietary | optional | dairy_free · gluten_free · low_salt · low_sugar · organic · vegan · vegetarian | Dietary / allergen tags the site filters on (all of them must apply). |
| min_health_star_rating | optional | 0.5–5 | Only products with at least this health star rating (0.5 steps). |
| in_stock_only = false | optional | — | Only products in stock at the store. |
| promotion | optional | all_promotions · specials · member_price · multibuy · low_price · half_price · online_only_specials | The site's promotion filters (any of them): specials, member_price (Everyday Rewards), multibuy, low_price, half_price, online_only_specials, all_promotions. |
| sort = relevance | optional | relevance · price_asc · price_desc · unit_price_asc | The site's own sorts. Price sorts leave out sponsored-only matches. |
| page = 1 | optional | 1–1000 | 1-based page. The site serves at most 1000 rows per query (page × page_size). |
| page_size = 48 | optional | 1–100 | Rows per page, 1-100 (the site's page is 48). |
| include_facets = true | optional | — | Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions). |
/woolworths-nz/v1/offer1 creditEvery product in one multi-buy offer group ('any 4 for $10.00'), by the offer_number a row's multi_buy / promotions carries (the site's /shop/offer-group/<number> page).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| offer_number | required | — | multi_buy.offer_number from a product row, or the offer-group URL. |
| store_id | optional | — | Woolworths store (pickup location) id from the stores action, e.g. 9058 = Queenstown. Prices differ per store; without it the site's default store for a new visitor is used (9171 Greville Road, Auckland; store_defaulted: true). |
| sort = relevance | optional | relevance · price_asc · price_desc · unit_price_asc | The site's own sorts. Price sorts leave out sponsored-only matches. |
| page = 1 | optional | 1–1000 | 1-based page. The site serves at most 1000 rows per query (page × page_size). |
| page_size = 48 | optional | 1–100 | Rows per page, 1-100 (the site's page is 48). |
| include_facets = true | optional | — | Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions). |
/woolworths-nz/v1/product1 creditOne product at one store: price, was-price, member price, multi-buy, unit price, every variant (per kg and each for weighed goods), barcode, size, description, ingredients, allergens, nutrition panel, country of origin, health stars, category path, images. NOT_FOUND for an unknown id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | The product_id of a search row (the site's stockcode, e.g. 282793) or the product page URL. |
| store_id | optional | — | Woolworths store (pickup location) id from the stores action, e.g. 9058 = Queenstown. Prices differ per store; without it the site's default store for a new visitor is used (9171 Greville Road, Auckland; store_defaulted: true). |
/woolworths-nz/v1/products2 creditsUp to 100 products by id in ONE request (the site's own by-sku lookup): the same row as search for each, in the order asked, at one store. Ids the store does not list come back in not_found.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_ids | required | — | 1-100 product ids (stockcodes) from search rows. |
| store_id | optional | — | Woolworths store (pickup location) id from the stores action, e.g. 9058 = Queenstown. Prices differ per store; without it the site's default store for a new visitor is used (9171 Greville Road, Auckland; store_defaulted: true). |
/woolworths-nz/v1/categories1 creditThe site's category tree: departments, aisles and shelves with their keys and URLs (pass any of them as `category`).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| department | optional | — | Only this department's branch (name, key or slug). |
/woolworths-nz/v1/stores1 creditWoolworths NZ stores and pickup points: store_id (pass it as store_id), name, address, suburb, region code, postcode, the store that prices it. Search by text, or sort by distance from a point.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Part of the store name, address, suburb or postcode (case-insensitive). |
| region | optional | — | Region code as the site prints it (AUK, WKO, BOP, WGN, CAN, OTA, STL, NTL, HKB, TKI, MWT, NSN, MBH, WTC, GIS, TAS). |
| latitude | optional | — | With longitude: nearest stores first, with distance_km (the site's own distance). |
| longitude | optional | — | With latitude. |
| limit = 250 | optional | 1–250 | How many to return (default all). |
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"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.