# SuperValue NZ Scraper | $4.00/1K (`architekture/supervalue-nz-scraper`) Actor

SuperValue New Zealand (supervalue.co.nz) product scraper: name, pack size, price in NZD, was price, unit price, special flag, tags, image and product URL from the SuperValue online shop (Milton). By keyword or category, with continuation. Pay per result, no login.

- **URL**: https://apify.com/architekture/supervalue-nz-scraper.md
- **Developed by:** [architek.earth](https://apify.com/architekture) (community)
- **Categories:** E-commerce, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.20 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SuperValue NZ Scraper | $4.00/1K

### What's new, 2026-11-16

Bounded examples, explicit costs and integration recipes. NZ pricing is unchanged; no launch price cut applies.

**Recorded run:** `bl5Tgo7K2PP4MZDtb` on 2026-11-15 returned 2 dataset rows; 2 primary events were charged. Status: `SUCCEEDED`. Dataset rows can include free status records.

Architekture, an independent data studio. architek.earth.

SuperValue NZ returns selected-store prices, specials and unit prices. Use the daily example to collect repeatable snapshots; use incremental mode only where the input exposes it.

### Tested this week

| Check | Our recorded sample | Field context, 2026-11-16 |
|---|---|---|
| Evidence window | 2026-11-15; within the last seven days | Rolling 30-day public counters across 1 title-bucket members |
| Outcome | SUCCEEDED; 2 dataset rows; 2 charged primary events | unavailable non-success over 0 runs |
| Cost | $0.001287 platform cost in the retained run | Not a competitor execution or a matched-input benchmark |

Field source: [public Store API](https://api.apify.com/v2/store?search=supervalue%20nz). Non-success includes failures, aborts and timeouts. The field total is not a unique-user count. These different workloads do not establish that our actor is more reliable.

### What, data and cost

One primary `product` event costs **$0.004**; 1,000 cost **$4.00**. Ten primary events plus one collection-delivered cost **$0.19**. Optional events below are additional; status rows are free.

**$5 free credit ≈ 1,212 products** at the primary launch rate after one initial collection-delivered charge. This estimate excludes optional event charges and additional collection starts. Credit pays for billed work; it is separate from the free preview.

Set `preview: true`. One bounded preview returns up to 10 data rows when the source has results. Preview rows are not charged. A preview never silently switches to paid collection.

#### Event prices

| Event | USD per event | When charged |
|---|---:|---|
| `product` | 0.004 | Delivered primary result |
| `collection-delivered` | 0.15 | Once per successful collection with delivered rows |

Free and Bronze use the full primary rate; Silver receives 10% off, and Gold, Platinum and Diamond receive 20% off. Secondary event prices do not change. Your run's effective price is shown before collection.

NZ pricing is unchanged; no launch price cut applies.

### Worth knowing up front

- **One store.** On 2026-11-14 only SuperValue Milton runs a SuperValue online catalogue; other SuperValue stores (for example Mangawhai) have no online search and return a free `INVALID_INPUT` row. Bell Block's shop is branded FreshChoice and belongs to the FreshChoice actor.
- Prices are store-scoped and come from the store's own online shop. The shops only answer New Zealand connections, so collection goes through a New Zealand residential address; that cost is included in the price.
- Search terms and category pages of the online shop are supported, 48 products per page.
- Not returned: barcodes, stock levels, nutrition or ingredients. `availability` is always `"unknown"`.
- A run stopped by its time bound or spending limit keeps what it delivered and saves `CHECKPOINT`; a run that stops early writes one free status row (`"recordType": "status"`) that says why.

### Input recipes

#### 1. Preview: Milk prices

[Open the configured example task](https://apify.com/architekture/supervalue-nz-scraper/examples/supervalue-nz-basket-compare)

```json
{
  "searchTerms": [
    "milk"
  ],
  "maxItemsPerQuery": 1,
  "storeId": "milton",
  "preview": true,
  "continuePreviousRun": false
}
```

#### 2. Daily: Milk prices at the selected store

[Open the configured example task](https://apify.com/architekture/supervalue-nz-scraper/examples/supervalue-nz-weekly-tracking)

```json
{
  "searchTerms": [
    "milk"
  ],
  "maxItemsPerQuery": 1,
  "storeId": "milton",
  "preview": false,
  "continuePreviousRun": false
}
```

#### 3. One-off: Bread prices

[Open the configured example task](https://apify.com/architekture/supervalue-nz-scraper/examples/m058-supervalue-nz-3)

```json
{
  "searchTerms": [
    "bread"
  ],
  "maxItemsPerQuery": 1,
  "storeId": "milton",
  "preview": false,
  "continuePreviousRun": false
}
```

#### 4. Daily: Butter prices at the selected store

[Open the configured example task](https://apify.com/architekture/supervalue-nz-scraper/examples/m058-supervalue-nz-4)

```json
{
  "searchTerms": [
    "butter"
  ],
  "maxItemsPerQuery": 1,
  "storeId": "milton",
  "preview": false,
  "continuePreviousRun": false
}
```

### Recurring collection

Copy the example [Daily: Milk prices at the selected store](https://apify.com/architekture/supervalue-nz-scraper/examples/supervalue-nz-weekly-tracking) into your account. Schedule it in UTC with:

```cron
0 9 * * *
```

The worked ten-result run above repeated daily costs about **$5.70 per 30 days** before optional events and discounts. These tiny recipes demonstrate the input; increase their row limits deliberately. Keep one watch identifier per consistent filter set where incremental mode is available.

### Output and limits

Read the [live input and output definitions](https://api.apify.com/v2/acts/architekture~supervalue-nz-scraper/builds/default). Keep source identifiers, capture time and any status fields when joining snapshots. The data fields remain additive; this listing change does not promise new source data.

### MCP config for Claude and Cursor

Claude: add a custom connector with URL `https://mcp.apify.com?tools=architekture/supervalue-nz-scraper` and complete its sign-in. For Cursor, add this entry to your MCP settings and set your own `APIFY_TOKEN`:

```json
{
  "mcpServers": {
    "supervalue-nz-scraper": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=architekture/supervalue-nz-scraper",
      "headers": {
        "Authorization": "Bearer ${env:APIFY_TOKEN}"
      }
    }
  }
}
```

### n8n and Make

[Python example](https://github.com/architek-earth/examples/blob/main/supervalue-nz-scraper/example.py) and [n8n workflow](https://github.com/architek-earth/examples/blob/main/supervalue-nz-scraper/n8n-workflow.json). In n8n, select a Header Auth credential with header `Authorization` and your bearer token. The workflow is inactive until you choose to run or schedule it.

In Make, add an HTTP request: `POST https://api.apify.com/v2/acts/architekture~supervalue-nz-scraper/run-sync-get-dataset-items?timeout=120&memory=2048&maxTotalChargeUsd=0.1780000`. Set `Content-Type: application/json`, configure your bearer-token credential, and paste one recipe as the JSON body. Parse the returned array and route status rows separately. Add a scheduler only after inspecting the first result. Do not automatically retry an ambiguous POST; first check whether a run was created.

### FAQ

The linked public field issues are context for these checks, not claims that the same defects exist in this actor. Grocery examples also use adjacent supermarket issues; tennis uses the adjacent tennis-data field.

#### Why can a green run contain no usable rows?

A completed run can still report an empty or blocked source. Read the status rows and run summary before treating it as a successful observation; a missing result is not a measured zero. [Observed field issue](https://apify.com/natanielsantos/sainsbury-s-scraper/issues/VroViV420O4MyZd49).

#### Why did I receive fewer rows than the limit?

The limit is a ceiling, not a guaranteed count. The source may have fewer public matches, filters may remove records, or the run may stop at a time or spending cap. Start with `maxItemsPerQuery`. [Observed field issue](https://apify.com/abotapi/aldi-com-au-scraper/issues/qK7hgyXH1fFverKDS).

#### Can this export the whole source?

The five examples are deliberately bounded. A title or catalogue estimate does not prove full coverage. Use only the collection and continuation modes documented in the input, and retain any partial-run status. [Observed field issue](https://apify.com/abotapi/woolworths-au-scraper/issues/2LGAT6Z7yqnsA055s).

#### Which direct identifiers or URLs are accepted?

The input exposes `categoryUrls`. Use their documented formats; a source URL is not automatically a valid value for a keyword field. [Observed field issue](https://apify.com/abotapi/woolworths-au-scraper/issues/rCtDTmbxzNwkBd1NG).

#### Why is an output field absent?

The source must publish a value for the actor to return it. Do not infer a missing price, salary, rating, ID or language. Check the output definition and preserve null or absent values in downstream storage. [Observed field issue](https://apify.com/abotapi/aldi-com-au-scraper/issues/oyPyPqccqJOOOEjMc).

#### How do I avoid counting a repeated snapshot twice?

Treat each ordinary run as a snapshot. Deduplicate downstream using the source identity and capture time; this listing does not claim cross-run deduplication where the input has no incremental mode. [Observed field issue](https://apify.com/radeance/tesco-scraper/issues/lXsCyyNOEaqkbwfkh).

#### What should I check after a source or proxy error?

Inspect the run message and the smallest configured example. Do not substitute login cookies or unrelated proxy credentials. A source wall is a coverage limit; preserve partial output and avoid treating failed checks as changes. [Observed field issue](https://apify.com/abotapi/woolworths-au-scraper/issues/oaXKQ0XUiUBA9lnce).

#### How do I bound the bill?

Set a run charge cap, for example `$0.178` for these tiny inputs, and keep row limits small. Ten primary results plus one collection/root-post charge cost $0.19 at the listed rate. Optional events and repeated checks add cost. [Observed field issue](https://apify.com/abotapi/woolworths-au-scraper/issues/g4GH2XGeeVDoLS6b5).

#### Does the preview switch to paid collection?

Set `preview: true`. One bounded preview returns up to 10 data rows when the source has results. Preview rows are not charged. A preview never silently switches to paid collection. [Observed field issue](https://apify.com/radeance/tesco-scraper/issues/BSJhZqtLwCuQ2lDXW).

#### What evidence helps diagnose a changed result?

Provide the run ID, intended country/store/date or filter, and one expected public source URL. Include the status message and missing field name. Never post credentials. The feedback input records a note and does not change output. [Observed field issue](https://apify.com/radeance/tesco-scraper/issues/01bEYMGjje4cAxF1Q).

### For AI agents

Call `architekture/supervalue-nz-scraper` with a bounded recipe and an explicit spending cap. Read the input schema first, request only supported fields, and inspect status rows before summarizing results. Preserve source IDs and capture times. Never interpret absent source data as a confirmed change. Use the same `watchId` for repeat observations only when this actor exposes incremental mode.

**Run health, reviewed 2026-11-16:** last retained run `bl5Tgo7K2PP4MZDtb`, SUCCEEDED, 2 dataset rows, observed 2026-11-15. No new run was started for this listing release.

### More from architek.earth

- [nz price monitor](https://apify.com/architekture/nz-price-monitor)
- [au price monitor](https://apify.com/architekture/au-price-monitor)
- [google shopping scraper](https://apify.com/architekture/google-shopping-scraper)

### Support and legal

Use this actor's [issue tab](https://apify.com/architekture/supervalue-nz-scraper/issues) for product questions. Public-source access does not remove your responsibility for permitted use, copyright and privacy. This is an independent product, not an official source API. architek.earth.

### Changelog

- **2026-11-16**: Bounded example tasks, dated health comparison, explicit worked costs, MCP and automation examples, and compatible input-name changes where applicable. NZ pricing is unchanged; no launch price cut applies.

#### Earlier releases

- **2026-11-16** : Support approved primary-event Store discount tiers; retain exact event checks and existing preview limits.

- **2026-11-15** : 0.1.2 first public release (runtime identical to canary build 0.1.1; README only).

# Actor input Schema

## `searchTerms` (type: `array`):

Product keywords, for example milk or weet-bix. Up to 100. Set to \[] for category-only collection.

## `categoryUrls` (type: `array`):

Category pages of the SuperValue online shop, for example https://milton.store.supervalue.co.nz/category/dairy-eggs, or just dairy-eggs.

## `storeId` (type: `string`):

The store's online shop address or its first word, for example milton for https://milton.store.supervalue.co.nz. Blank selects SuperValue Milton.

## `maxItemsPerQuery` (type: `integer`):

Cap per search term or category across a continuation chain. 0 means no cap; time and spending limits still apply.

## `preview` (type: `boolean`):

Free on every run: one page and up to 10 products, never charged. Turn off for paid collection.

## `continuePreviousRun` (type: `boolean`):

Paid only. Picks up from the previous run's saved checkpoint, once.

## `previousStoreId` (type: `string`):

The previous run's default key-value store (holds CHECKPOINT and CHECKPOINT_META). Not a supermarket store ID.

## `previousQueueId` (type: `string`):

queueId from the previous run's CHECKPOINT_META. Needed only for continuation; it stops one checkpoint being used twice.

## `maxRunSeconds` (type: `integer`):

The run stops itself cleanly before this many seconds and saves a checkpoint.

## `feedback` (type: `string`):

Tell us what you needed and did not get. Read by a human; never changes the output.

## Actor input object example

```json
{
  "searchTerms": [
    "milk"
  ],
  "categoryUrls": [],
  "maxItemsPerQuery": 100,
  "preview": true,
  "continuePreviousRun": false,
  "maxRunSeconds": 240
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `checkpoint` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("architekture/supervalue-nz-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("architekture/supervalue-nz-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call architekture/supervalue-nz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,architekture/supervalue-nz-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/iZKbhZdh4sSdDdbOc/builds/qhrPipClCC5SCtNZi/openapi.json
