Foodstuffs Grocery Data API · Live

Pull live Foodstuffs data
in the time it takes
to read this sentence.

Prices, Clubcard specials, price-per-unit, and stock across New World, PAK'nSAVE, and Four Square — structured and delivered as clean JSON or CSV. No proxies to manage, no CAPTCHAs to solve, no HTML to parse.

See a Live Response

100K+ Products Tracked

8M+ Daily Price Checks

3 Banners Covered

Real-Time Data Refresh

GET /v1/foodstuffs/product

LIVE

// request timestamp 2026-07-20 04:31:10 UTC { "product_id": "FS-661234", "store": "PAK'nSAVE Wairau Rd", "title": "Watties Baked Beans, 4x420g", "price": { "amount": 6.50, "currency": "NZD", "clubcard_special_price": 5.00, "special_active": true }, "price_per_unit": "$2.98/kg", "rating": 4.7, "review_count": 920, "availability": "in_stock", "fetched_in_ms": 1738 }

Why Choose Our Foodstuffs API

Three banners, three pricing strategies, one co-operative structure behind them.

New World, PAK'nSAVE, and Four Square operate under the Foodstuffs co-operative model, each with distinct pricing positioning and store-level ownership. Our infrastructure resolves pricing and Clubcard specials consistently across all three.

01

Zero blocking, zero maintenance

We run rotating residential IPs, headless rendering, and CAPTCHA-solving behind every request. When any Foodstuffs banner changes its layout, we patch our parsers — your integration never breaks.

02

Clubcard specials aware

Every price response separates the regular price from any active New World Clubcard special, plus the saving amount.

03

Store-level price variation resolved

Foodstuffs stores are independently owned and often price differently — we resolve pricing per store, not a single national average.

04

Built for scale from day one

From a 100-SKU test batch to a full grocery catalog checked daily across banners, the same endpoint scales with you.

Foodstuffs API Features

Everything you need to keep Foodstuffs data flowing.

⚡

Real-time Extraction

Trigger an on-demand pull for any product ID or keyword and get a fresh response — not a stale cache.

🧩

Custom Field Selection

Request only the fields you need — price, nutrition, reviews — to cut payload size and parsing time.

🎫

Clubcard Special Detection

Flag active Clubcard specials and multibuy deals automatically alongside standard price.

📦

Bulk & Scheduled Requests

Submit thousands of product IDs in one batch job or schedule recurring pulls on an hourly, daily, or custom cadence.

🥗

Nutritional & Allergen Data

Pull structured nutrition tables, allergen flags, and per-100g pricing for every grocery item.

📊

Historical Price Tracking

Store and query price and special history per product to power repricing and basket-cost analysis.

What Data Can You Access?

Every field a listing page shows — nutrition and unit pricing included.

CoreTitle & product IDSKU, barcode, brand

PricingPrice & Clubcard specialRegular price, special price, saving

PricingPrice per unitPrice per 100g/kg/litre for comparison

PromosMultibuy deals"2 for $X" and bundle offers

MediaImages & packagingAll gallery images at full resolution

ReviewsRatings & review countAverage rating, star breakdown

ReviewsIndividual reviewsText, rating, verified badge, date

NutritionNutritional tablePer 100g and per serving values

NutritionAllergen informationContains / may contain flags

StructureCategory breadcrumbsFull aisle & category tree path

SearchSearch result rankingsRelevance + sponsored position

FulfillmentClick & Collect / delivery slotNext available slot by store

Supported Foodstuffs Banners

New World, PAK'nSAVE, and Four Square — one integration.

Switch the banner parameter to pull from a different Foodstuffs store brand with the same consistent response shape.

🛒

New World

Full-service supermarket with Clubcard personalized specials.

📦

PAK'nSAVE

No-frills, everyday-low-price discount supermarket format.

🏪

Four Square

Convenience-focused local and regional grocery stores.

NZ-wide

Store-level pricing across all three banners

Store ID

Resolve pricing for a specific store location

Real-time

Price and special data checked on every request

Foodstuffs API Endpoints

A small set of endpoints that cover the whole grocery lifecycle.

Method	Endpoint	Description	Typical use
GET	/v1/foodstuffs/product	Full product detail by product ID or URL	Price & availability monitoring
GET	/v1/foodstuffs/search	Keyword or category search results	Market & competitor discovery
GET	/v1/foodstuffs/reviews	Paginated customer reviews for a product	Sentiment analysis
GET	/v1/foodstuffs/deals	Active Clubcard specials & multibuy promos	Promo & pricing intelligence
GET	/v1/foodstuffs/delivery-slots	Next available delivery/collection slots by store	Fulfilment planning
POST	/v1/foodstuffs/bulk	Submit up to 10,000 product IDs per batch job	Catalog-wide monitoring
GET	/v1/foodstuffs/category	Aisle & category tree metadata	Taxonomy mapping

Live API Response Example

This is exactly what comes back. No extra parsing needed.

Popular Foodstuffs API Use Cases

Built for the teams that live and die by Foodstuffs data.

📈

Basket Cost & Inflation Tracking

Monitor grocery price movements across categories and banners to power cost-of-living indices.

🔍

Market Research

Analyze category trends, pricing bands, and promo cadence across New World and PAK'nSAVE.

🛡️

Brand Distribution Tracking

Track where and at what price your brand's products are listed and promoted.

💬

Review & Nutrition Mining

Pull reviews and nutritional data to power diet, allergen, or health-tracking apps.

🚚

Delivery Slot Monitoring

Track slot availability by store for fulfillment planning or slot-booking tools.

📦

Recipe & Meal-planning Sourcing

Sync live ingredient pricing and availability into recipe or meal-planning apps.

🏆

Cross-banner Benchmarking

Compare pricing for the same product between New World, PAK'nSAVE, and competitors.

🧭

ML Training Data

Generate labeled product, price, and nutrition datasets for grocery recommendation models.

How the Foodstuffs API Works

From API key to structured data in five steps.

1

Get your API key

Sign up and generate a key from your dashboard in under two minutes.

2

Choose an endpoint

Pick /product, /search, /reviews or /deals depending on what you need.

3

Send the request

Call the endpoint with a product ID, keyword, or URL and your banner and store parameters.

4

We handle the hard part

Proxies, headless rendering, CAPTCHA-solving, and parsing all happen behind the scenes.

5

Receive structured data

Get clean JSON or CSV back in seconds, ready to drop into your pipeline.

Developer-Friendly Integration

Built by people who read the docs too.

One consistent JSON schema across every endpoint and every banner. No SDK lock-in — plain REST calls work from any language or platform.

→

Predictable REST design

Standard HTTP verbs, query params, and status codes — nothing proprietary to learn.

→

JSON, CSV, or webhook delivery

Get results inline, as a downloadable file, or pushed to your endpoint when a batch job finishes.

→

Sandbox & test keys

Free sandbox environment with sample product IDs so you can build before you pay.

→

Postman collection & SDK snippets

Import a ready-made collection or copy request snippets for Python, Node.js, and cURL.

Quickstart

API Performance & Reliability

Numbers we publish because we track them daily.

99.9%

Uptime SLA

<3s

Avg. response time

99.3%

Successful extraction rate

10K+

Concurrent requests supported

Security & Compliance

Compliant by design, not as an afterthought.

🔒

Encrypted in transit

All requests and responses travel over TLS 1.2+. API keys can be scoped and rotated anytime.

⚖️

NZ Privacy Act & global alignment

Our extraction workflows are built around New Zealand's Privacy Act alongside GDPR and CCPA guidelines.

🌐

Public-data-only policy

We collect only publicly accessible listing data — never login-gated or private account information.

✓ISO 9001:2015 Certified ✓ISO/IEC 27001:2013 Certified ✓IAF Multilateral Recognition ✓GDPR-aligned workflows

API Documentation & Resources

Everything to go from key to production.

Guide

Quickstart Guide

Get your first API response back in under five minutes.

Read guide →

Reference

Full API Reference

Every endpoint, parameter, and response field documented in detail.

View reference →

Tool

Postman Collection

Import ready-made requests for every Foodstuffs API endpoint.

Download →

Code

SDKs & Code Samples

Python, Node.js, PHP, and Ruby snippets for every use case.

Browse samples →

Frequently Asked Questions

Still deciding? Here's what most teams ask first.

We collect only publicly accessible listing data using automated tools, following publicly available web-data guidelines. We recommend reviewing your own use case with legal counsel, especially for redistribution.

Every request to /product, /search, and /deals triggers a live pull — you're not reading from a stale cache. Bulk jobs complete within minutes depending on batch size.

Yes — Foodstuffs stores are independently owned and can price differently even within the same banner. Pass a store ID to get pricing specific to that location.

Yes. The /product and /deals endpoints return both prices separately, along with the saving amount when a Clubcard special is active.

Our infrastructure retries automatically across a rotating proxy pool. You're only billed for successfully returned responses.

Yes, every account starts with a free sandbox key and sample credits so you can test all endpoints before committing to a plan.

By APIs

Ecommerce Scraping API

Food Scraping API

Grocery Scraping API

Travel Scraping API

Real Estate Scraping API

Quick Commerce Scraping API

Finance & Stock Scraping API

Social Media Scraping API

OTT Scraping API

Liquor Scraping API

Recruitment Scraping API

Healthcare Scraping API

Fashion Scraping API

Car Rental Scraping API

Solutions

Web Data

Solutions

Web Unlocker API

Anti Blocking

Live Crawler

Scraping Browser API

Lifestyle & Retail

Web Scraping Services

Web Scraping API Services

Mobile App Scraping services

Enterprise Web Crawling

Trending

Ecommerce

Grocery / Quick Commerce

Food

Travel

E-Commerce

Food

Grocery

Travel

Real-Estate

OTT

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

India

USA

UK

UAE

China

Looking for a Custom API?

Use Cases (View More ⭢)

Price Comparison

Dynamic Pricing

Market Research

Robotic Process Automation (RPA)

Product Development

Pull live Foodstuffs data
in the time it takes
to read this sentence.