Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Woolworths NZ API page →
docs / woolworths-nz

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.

base /woolworths-nz/v18 endpoints
post/woolworths-nz/v1/specials2 credits

The 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.

ParameterAllowed / rangeDescription
promotionoptionalall_promotions · specials · member_price · multibuy · low_price · half_price · online_only_specialsThe site's promotion filters (any of them): specials, member_price (Everyday Rewards), multibuy, low_price, half_price, online_only_specials, all_promotions.
categoryoptional—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_idoptional—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).
brandoptional—One or more brands, as the site lists them in facets.brands (any of them; case-insensitive).
dietaryoptionaldairy_free · gluten_free · low_salt · low_sugar · organic · vegan · vegetarianDietary / allergen tags the site filters on (all of them must apply).
min_health_star_ratingoptional0.5–5Only products with at least this health star rating (0.5 steps).
in_stock_only = falseoptional—Only products in stock at the store.
sort = relevanceoptionalrelevance · price_asc · price_desc · unit_price_ascThe site's own sorts. Price sorts leave out sponsored-only matches.
page = 1optional1–10001-based page. The site serves at most 1000 rows per query (page × page_size).
page_size = 48optional1–100Rows per page, 1-100 (the site's page is 48).
include_facets = trueoptional—Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions).
Try in playground →
post/woolworths-nz/v1/category2 credits

Browse 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.

ParameterAllowed / rangeDescription
categoryrequired—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_idoptional—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).
brandoptional—One or more brands, as the site lists them in facets.brands (any of them; case-insensitive).
dietaryoptionaldairy_free · gluten_free · low_salt · low_sugar · organic · vegan · vegetarianDietary / allergen tags the site filters on (all of them must apply).
min_health_star_ratingoptional0.5–5Only products with at least this health star rating (0.5 steps).
in_stock_only = falseoptional—Only products in stock at the store.
promotionoptionalall_promotions · specials · member_price · multibuy · low_price · half_price · online_only_specialsThe site's promotion filters (any of them): specials, member_price (Everyday Rewards), multibuy, low_price, half_price, online_only_specials, all_promotions.
sort = relevanceoptionalrelevance · price_asc · price_desc · unit_price_ascThe site's own sorts. Price sorts leave out sponsored-only matches.
page = 1optional1–10001-based page. The site serves at most 1000 rows per query (page × page_size).
page_size = 48optional1–100Rows per page, 1-100 (the site's page is 48).
include_facets = trueoptional—Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions).
Try in playground →
post/woolworths-nz/v1/offer1 credit

Every 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).

ParameterAllowed / rangeDescription
offer_numberrequired—multi_buy.offer_number from a product row, or the offer-group URL.
store_idoptional—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 = relevanceoptionalrelevance · price_asc · price_desc · unit_price_ascThe site's own sorts. Price sorts leave out sponsored-only matches.
page = 1optional1–10001-based page. The site serves at most 1000 rows per query (page × page_size).
page_size = 48optional1–100Rows per page, 1-100 (the site's page is 48).
include_facets = trueoptional—Include the counts the site shows beside its filters (brands, dietary, health stars, departments/aisles, promotions).
Try in playground →
post/woolworths-nz/v1/product1 credit

One 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.

ParameterAllowed / rangeDescription
product_idrequired—The product_id of a search row (the site's stockcode, e.g. 282793) or the product page URL.
store_idoptional—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).
Try in playground →
post/woolworths-nz/v1/products2 credits

Up 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.

ParameterAllowed / rangeDescription
product_idsrequired—1-100 product ids (stockcodes) from search rows.
store_idoptional—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).
Try in playground →
post/woolworths-nz/v1/categories1 credit

The site's category tree: departments, aisles and shelves with their keys and URLs (pass any of them as `category`).

ParameterAllowed / rangeDescription
departmentoptional—Only this department's branch (name, key or slug).
Try in playground →
post/woolworths-nz/v1/stores1 credit

Woolworths 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.

ParameterAllowed / rangeDescription
queryoptional—Part of the store name, address, suburb or postcode (case-insensitive).
regionoptional—Region code as the site prints it (AUK, WKO, BOP, WGN, CAN, OTA, STL, NTL, HKB, TKI, MWT, NSN, MBH, WTC, GIS, TAS).
latitudeoptional—With longitude: nearest stores first, with distance_km (the site's own distance).
longitudeoptional—With latitude.
limit = 250optional1–250How many to return (default all).
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.