New World API

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
5 active endpoints, on 1 and 2 credit tiers.Every parameter ↓OpenAPI 3.0 spec ↗

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

Get a free API key
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.

New World API

4 of 5 endpoints, ready to run

View docs ↗

Milk prices at New World Remuera

2 credits0 required · 2 optional
POST/new-world/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 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 cr

    Search 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 cr

    Everything 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 cr

    One product at one New World store.

    required
    product_id
    optional
    store_id
  • categories

    2 cr

    The category tree of one New World store (names and paths to pass as category).

    required
    —
    optional
    store_id
  • stores

    2 cr

    The 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 it works

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.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

Call02
POST /new-world/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

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

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01stores?query=Auckland
GET/new-world/v1/stores?query=Auckland

The 31 New World stores in the Auckland region with id, address, island, own phone number, opening hours and click & collect / delivery flags.

02search?query=milk&store_id=Remuera
GET/new-world/v1/search?query=milk&store_id=Remuera

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.

03product?product_id=5002650-EA-000&store_id=Remuera
GET/new-world/v1/product?product_id=5002650-EA-000&store_id=Remuera

The full record: barcode, ingredients, allergens, nutrition panel, images and the deal with its start and end dates.

04deals?store_id=Remuera&category=Pantry
GET/new-world/v1/deals?store_id=Remuera&category=Pantry

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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "new-world",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
store_id, store_name, store_defaultedThe 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).
priceWhat 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_priceThe 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_buyA 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.
promotionsEvery 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_priceThe 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, plubarcode 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_promotionThe 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_regionNI 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.

Coverage

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.

Stores

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.

Store matters

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.

Club+ prices

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.

Catalogue

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

Product record

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

Speed

Median 4.9 s per search and 4.6 s per product call over 11 calls; store lists 2 to 4 s.

Limits

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.

Use cases

What people build with New World

The jobs this data is most often used for.

01

Compare New World prices between stores, islands and regions of New Zealand.

02

Track weekly Club+ prices and multi-buys at the New World stores you follow.

03

Build a New Zealand grocery product database with barcodes, ingredients, allergens and nutrition.

04

Compare unit prices per litre or per kilo across pack sizes.

5

endpoints

1/2

credits per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
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/new-world/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/new-world/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 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.

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