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 New World API page →
docs / new-world

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.

base /new-world/v15 endpoints
post/new-world/v1/deals2 credits

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

ParameterAllowed / rangeDescription
queryoptional—Optional text to narrow the deals.
categoryoptional—Category path from the `categories` action, 1-3 levels joined by ' > ' (e.g. 'Pantry' or 'Fridge, Deli & Eggs > Milk > Fresh Milk'). Case-insensitive.
store_idoptional—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).
brandoptional—Only this brand, as a row's `brand` field gives it (case-insensitive).
dietaryoptional—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 = relevanceoptionalrelevance · price_asc · price_desc · unit_price_asc · unit_price_descOrder 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 = 1optional1–20Page number, 1-20, 50 products per page. The source shows at most the first 1000 products of a result (total_capped says when).
Try in playground →
post/new-world/v1/product1 credit

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

ParameterAllowed / rangeDescription
product_idrequired—The product_id of a search row (e.g. 5201490-EA-000, 5046542-KGM-000) or the product page URL.
store_idoptional—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).
Try in playground →
post/new-world/v1/categories2 credits

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

ParameterAllowed / rangeDescription
store_idoptional—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).
Try in playground →
post/new-world/v1/stores2 credits

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

ParameterAllowed / rangeDescription
queryoptional—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.
regionoptionalNI · SIOnly New World stores on this island: NI = North Island (106 stores), SI = South Island (43 stores; counts measured 2026-11-22).
latitudeoptional—With longitude: sort stores by straight-line distance from this point (distance_km).
longitudeoptional—With latitude.
limit = 200optional1–200How many stores 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.