New World
New Zealand grocery prices per New World store: NZD price, Club+ card price, multi-buys, unit price per kg or litre, ingredients and nutrition, and the 149-store directory.
/new-world/v1/search2 creditsSearch one New World store's online range (newworld.co.nz, New Zealand): shelf price in NZD, the Club+ card price kept apart from the price (`member_price`), multi-buy ("2 for $6.00"), unit price, sold-by-weight details, online / in-store availability, dietary tags and every category placement per product. `query` or `category` is required (either one); filter by brand, dietary tag or deals. 50 products per page, the first 1000 of a result.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | What to search for, as typed in the site's search box. Required unless category is given. |
| category | optional | — | Category path from the `categories` action, 1-3 levels joined by ' > ' (e.g. 'Pantry' or 'Fridge, Deli & Eggs > Milk > Fresh Milk'). Case-insensitive. |
| store_id | optional | — | New World store whose prices, deals and range you want: a store_id from the `stores` action (91e4dddd-aed7-4ccc-ad0b-dfe25805a495 = New World Remuera), or part of a store name ('Remuera', 'Howick', 'Alexandra'). Prices differ by store. Without it New World Remuera (Auckland) is used and the answer says so (store_defaulted: true). |
| brand | optional | — | Only this brand, as a row's `brand` field gives it (case-insensitive). |
| dietary | optional | — | Only products with this dietary tag, as a row's `dietary` list gives it (e.g. Gluten Free, Vegan, Vegetarian, Non-GMO, Low Fat, Low Sugar). |
| on_promotion = false | optional | — | Only products on a deal at this store (sale price, multi-buy or club-card price). |
| sort = relevance | optional | relevance · price_asc · price_desc · unit_price_asc · unit_price_desc | Order of the results. The unit-price sorts are the site's own: it ranks the number alone, whatever the unit ("$0.45/ea" before "$0.58/100g" before "$1.89/1L"), using the deal's unit price where a deal is on; to compare across units use each row's unit_price_per_kg / unit_price_per_l (a warning says when a page mixes units). |
| page = 1 | optional | 1–20 | Page number, 1-20, 50 products per page. The source shows at most the first 1000 products of a result (total_capped says when). |
/new-world/v1/deals2 creditsEverything on a deal at one New World store (the site's Deals page): sale prices, multi-buys and Club+ card prices, optionally narrowed by query, category, brand or dietary tag. Reports the store's own count of deals (total_on_promotion, e.g. 3325 at New World Remuera on 2026-11-22) beyond the 1000-row window.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Optional text to narrow the deals. |
| category | optional | — | Category path from the `categories` action, 1-3 levels joined by ' > ' (e.g. 'Pantry' or 'Fridge, Deli & Eggs > Milk > Fresh Milk'). Case-insensitive. |
| store_id | optional | — | New World store whose prices, deals and range you want: a store_id from the `stores` action (91e4dddd-aed7-4ccc-ad0b-dfe25805a495 = New World Remuera), or part of a store name ('Remuera', 'Howick', 'Alexandra'). Prices differ by store. Without it New World Remuera (Auckland) is used and the answer says so (store_defaulted: true). |
| brand | optional | — | Only this brand, as a row's `brand` field gives it (case-insensitive). |
| dietary | optional | — | Only products with this dietary tag, as a row's `dietary` list gives it (e.g. Gluten Free, Vegan, Vegetarian, Non-GMO, Low Fat, Low Sugar). |
| sort = relevance | optional | relevance · price_asc · price_desc · unit_price_asc · unit_price_desc | Order of the results. The unit-price sorts are the site's own: it ranks the number alone, whatever the unit ("$0.45/ea" before "$0.58/100g" before "$1.89/1L"), using the deal's unit price where a deal is on; to compare across units use each row's unit_price_per_kg / unit_price_per_l (a warning says when a page mixes units). |
| page = 1 | optional | 1–20 | Page number, 1-20, 50 products per page. The source shows at most the first 1000 products of a result (total_capped says when). |
/new-world/v1/product1 creditOne product at one New World store: price, Club+ card price, multi-buy with start / end dates, unit price, barcode (or PLU for weighed goods), description, ingredients, allergens, nutrition panel, dietary tags, origin, images and availability. NOT_FOUND when the store does not sell it. Product ids are the same as on PAK'nSAVE; the price is New World's.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | The product_id of a search row (e.g. 5201490-EA-000, 5046542-KGM-000) or the product page URL. |
| store_id | optional | — | New World store whose prices, deals and range you want: a store_id from the `stores` action (91e4dddd-aed7-4ccc-ad0b-dfe25805a495 = New World Remuera), or part of a store name ('Remuera', 'Howick', 'Alexandra'). Prices differ by store. Without it New World Remuera (Auckland) is used and the answer says so (store_defaulted: true). |
/new-world/v1/categories2 creditsThe category tree of one New World store (names and paths to pass as `category`).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| store_id | optional | — | New World store whose prices, deals and range you want: a store_id from the `stores` action (91e4dddd-aed7-4ccc-ad0b-dfe25805a495 = New World Remuera), or part of a store name ('Remuera', 'Howick', 'Alexandra'). Prices differ by store. Without it New World Remuera (Auckland) is used and the answer says so (store_defaulted: true). |
/new-world/v1/stores2 creditsThe New World store directory (149 stores): store_id, name, address, region, island, coordinates, the store's own phone, opening hours, click & collect / delivery. Narrow by text (name, address, city or region) or island, or sort by distance from a point.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Part of the New World store name, address, city, locality or region (case-insensitive): 'Auckland' finds every New World store in the Auckland region (31), also those whose address does not say Auckland. |
| region | optional | NI · SI | Only New World stores on this island: NI = North Island (106 stores), SI = South Island (43 stores; counts measured 2026-11-22). |
| latitude | optional | — | With longitude: sort stores by straight-line distance from this point (distance_km). |
| longitude | optional | — | With latitude. |
| limit = 200 | optional | 1–200 | How many stores to return (default all). |
curl -X POST https://api.reefapi.com/new-world/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.