Every New World price and Club+ deal, store by store
- endpoints
- 5
- credits per call
- 1–2
The New World API returns New World supermarket data from newworld.co.nz, New Zealand, as JSON, one store at a time, because New World prices every product per store: on 2026-11-22 Anchor Butter 500 g was $9.29 with a Club+ price of $7.99 at New World Remuera and $9.39 with no Club+ price at New World Alexandra (the same product id cost $8.79 at PAK'nSAVE Royal Oak).
/new-world/v1
- POST/new-world/v1/search2 credits
- POST/new-world/v1/deals2 credits
- POST/new-world/v1/product1 credit
- POST/new-world/v1/categories2 credits
- POST/new-world/v1/stores2 credits
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
Get a free API keyRun 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.
New World API
4 of 5 endpoints, ready to run
Milk prices at New World Remuera
// 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.
What New World endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
search
2 crSearch one New World store's online range (newworld.co.nz, New Zealand).
- required
- —
- optional
- query, category, store_id, brand, dietary, on_promotion, sort, page
deals
2 crEverything on a deal at one New World store (the site's Deals page).
- required
- —
- optional
- query, category, store_id, brand, dietary, sort, page
product
1 crOne product at one New World store.
- required
- product_id
- optional
- store_id
categories
2 crThe category tree of one New World store (names and paths to pass as category).
- required
- —
- optional
- store_id
stores
2 crThe New World store directory (149 stores).
- required
- —
- optional
- query, region, latitude, longitude, limit
Every parameter, every allowed value →
Missing a New World endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the New World API works
New World is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a New World store to a priced basket with every Club+ deal
Pick the store, search it, then read the products and deals that matter. Same data as /paknsave-api with the shop fixed to New World; calls to POST /paknsave/v1/... with banner=newworld keep working unchanged.
The 31 New World stores in the Auckland region with id, address, island, own phone number, opening hours and click & collect / delivery flags.
The store's products with price, Club+ price, multi-buy, unit price with its per-kg or per-litre equivalent, availability, dietary tags and categories.
The full record: barcode, ingredients, allergens, nutrition panel, images and the deal with its start and end dates.
Everything on a deal in one department of that store.
A store-specific New Zealand grocery price and deal feed for New World, with Club+ prices kept apart from shelf prices.
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": { … },
"meta": {
"api": "new-world",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a New World field actually contains
Fields that read differently from how they look. Every example was read from live New World responses on 2026-11-22.
| Field | What it holds |
|---|---|
| store_id, store_name, store_defaulted | The New World store the prices belong to. store_defaulted is true when you did not pass a store; the answer still names the store used (New World Remuera). |
| price | What anyone pays for one unit now, in NZD, without a Club+ card. For goods sold by weight it is the price per kg (price_unit "kg"): orange kumara at New World Howick read 7.49. |
| member_price | The Club+ card price, never the price: Anchor Butter 500 g at Remuera showed price 9.29 and member_price 7.99; Chelsea White Sugar at Howick 4.69 and 3.29. member_price_program says "Club+" (New World's Clubcard became Club+ in July 2026). null when there is no card price. |
| multi_buy | A deal on several units, kept apart from the single price, for example vine tomatoes "2 for $6.00" (quantity 2, price 6.00). card_required says when it needs a Club+ card. |
| promotions | Every deal on the product with its type, deal price, whether a card is needed and, on the product call, the start and end dates (Anchor Butter: 2026-11-16 to 2026-11-22). |
| unit_price | The site's comparison price, for example 2.36 per 1 L for a 2 L milk. unit_price_per_kg and unit_price_per_l bring weight and volume to one scale; null for prices per each or per 100 sheets. |
| barcode, plu | barcode is the EAN of packed goods (9415077379187 for Pams Value Standard Milk 2 L); weighed goods carry a short store code instead, returned as plu (4817 for orange kumara). |
| total, total_capped, total_on_promotion | The shop shows at most the first 1,000 products of any result; total_capped is true when the count stops there. For deals, total_on_promotion is the store's own count of deals (3,325 at Remuera). |
| store_region | NI or SI: the island of the store. stores takes region=NI or SI to list one island. |
New World does not publish a was-price or a stock count to visitors: availability is online / in store only. Ratings are not included.
New World coverage, measured
Every number below was read from live responses on 2026-11-22: searches at New World Remuera, Albany and Alexandra, deals, products, the category tree and the full store list, plus 14 calls (11 of them repeating real customer requests) run through both this API and /paknsave-api with banner=newworld, which returned the same data 14 of 14 times.
149 New World stores: 106 on the North Island and 43 on the South Island, 31 of them in the Auckland region. 144 carry the store's own phone number, 146 offer click & collect and 146 delivery, 149 have opening hours.
Anchor Butter 500 g (5002650-EA-000) was $9.29 with a Club+ price of $7.99 at New World Remuera and $8.79 with no card price at PAK'nSAVE Royal Oak on the same morning, and $9.39 with no Club+ price at New World Alexandra. Product ids are shared with PAK'nSAVE; the price is New World's.
New World Remuera had 3,325 products on a deal. On the first page of its deals, 32 of 50 carried a Club+ price and 9 a multi-buy ("2 for $6.00" vine tomatoes); all 50 chocolate deals carried a Club+ price. Club+ prices sit in member_price, never in price.
"milk" 86 products at Remuera (prices $1.29 to $8.99 on page 1), the Milk aisle 102 products at New World Alexandra on the South Island, 787 categories in 15 departments at Remuera.
Pams Value Standard Milk 2 L came back with 30 of 45 fields filled: price, barcode, ingredients, allergens, a 16-line nutrition panel, images, categories and availability. Weighed goods carry a price per kg and a PLU instead of a barcode (orange kumara: $7.49 per kg, PLU 4817).
Median 4.9 s per search and 4.6 s per product call over 11 calls; store lists 2 to 4 s.
One store per call; 50 rows per page and the first 1,000 products of a result; no was-price and no stock count (online / in-store availability only); no ratings; personalised offers that need a login are not included.
What people build with New World
The jobs this data is most often used for.
Compare New World prices between stores, islands and regions of New Zealand.
Track weekly Club+ prices and multi-buys at the New World stores you follow.
Build a New Zealand grocery product database with barcodes, ingredients, allergens and nutrition.
Compare unit prices per litre or per kilo across pack sizes.
endpoints
credits per call
What New World 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.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
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 -X POST https://api.reefapi.com/new-world/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/new-world/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up New World.
Is there a New World API?▾
Yes. This API reads newworld.co.nz live and returns prices, Club+ prices, deals, product records and the store list as JSON. Nothing here needs a New World account: everything is read logged out, as any visitor sees it.
Is the Club+ price the price I get?▾
Only with a Club+ card. price is what everyone pays; member_price is the Club+ price. On the first page of New World Remuera's deals on 2026-11-22, 32 of 50 products carried a Club+ price, and all 50 chocolate deals did.
Why does the price depend on the store?▾
Because New World prices every store separately: Anchor Butter 500 g was $9.29 with a Club+ price of $7.99 at New World Remuera and $9.39 with no Club+ price at New World Alexandra on the same morning (2026-11-22). Pass store_id from the stores call, or part of a store name such as Remuera or Howick; without one the API reads New World Remuera and says so.
Which currency are the prices in?▾
New Zealand dollars (NZD), as the shop prints them; every row carries currency "NZD".
Does it cover the South Island?▾
Yes. 43 of the 149 New World stores are on the South Island; the Milk aisle at New World Alexandra (Otago) returned 102 products. Pass region=SI to the stores call to list them.
How is this different from the PAK'nSAVE API?▾
It is the same data as /paknsave-api with the shop fixed to New World, so you never pass banner. Product ids are shared between the two shops, prices are not. Existing calls to POST /paknsave/v1/... with banner=newworld keep working unchanged.
How many results can I page through?▾
50 per page and up to 20 pages, because the shop itself stops at the first 1,000 products of any result. Narrow by category, brand or dietary tag to reach the rest.
Does it return stock levels or ratings?▾
No. New World publishes only whether a product is available online and in store, no stock count, and no ratings.
What is the New World API?▾
New World API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /new-world/v1.
Is the New World API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. New World calls use the same shared credit balance as every other ReefAPI engine.
Do I need a New World login or account?▾
No login to New World 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 New World 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 New World API use?▾
New World 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 New World from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call new-world actions with the same key, credit pool and JSON envelope used by normal REST requests.
390 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling New World, you are one call away from the rest of the category — no second contract, no second integration.
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.
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 745 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.