# Realestate.co.nz Scraper (`solidcode/realestate-co-nz-scraper`) Actor

\[💰 $1.00 / 1K] Extract property listings from Realestate.co.nz, New Zealand's national real-estate portal. Search by URL or by region, category, property type, price and bedrooms. Get prices, areas, locations, photos, open-home times and agent details.

- **URL**: https://apify.com/solidcode/realestate-co-nz-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Real estate, Developer tools, Automation
- **Stats:** 6 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Realestate.co.nz Scraper

Pull property listings from Realestate.co.nz — New Zealand's national real-estate portal — at scale: asking prices, weekly rents, floor and land areas, geo coordinates, full-resolution photo galleries, open-home schedules, and the listing agent's phone, mobile and email. One flat row per listing, 34 fields wide, across all eight listing categories. Search all of New Zealand by region, district and suburb, or just paste the URLs you already have. Built for property investors, buyer's agents, mortgage brokers, and proptech teams who need fresh New Zealand listing data without building and maintaining their own data extraction pipeline.

### Why This Scraper?

- **Eight listing categories in one actor** — residential for sale, residential for rent, new homes, lifestyle, rural, commercial for sale, commercial for lease, and businesses for sale; switch with a single dropdown.
- **A contactable agent on 99.8% of listings** — the agency office name and a landline land on 1,197 of 1,200 sampled listings, and the agent's name, direct mobile and email on 1,110 of them (93%). Sale listings carry the full set almost universally; rentals are the thin patch, at 57%.
- **Photo galleries up to 94 images, every one at 1296×864** — a typical listing returns 18, rebuilt at the same resolution the site itself serves and kept in gallery order, not thumbnail-sized previews.
- **Open-home schedules with start and end times** — structured start/end pairs stamped in New Zealand local time, on 73% of residential-for-sale listings. Rentals and commercial stock rarely run open homes, so they mostly come back empty.
- **Region → district → suburb targeting** — name any New Zealand location ("Auckland", "North Shore", "Ponsonby") and the actor resolves it to the right area automatically; leave it blank to sweep the whole country.
- **Category-aware price filtering in NZD** — minimum and maximum price applied as total sale price for buy categories and as weekly rent for rentals, so the same field does the right thing everywhere.
- **Ten property-type filters** — house, apartment, townhouse, unit, studio, section (land), lifestyle property, lifestyle section, home & income, and carpark, combinable in a single search.
- **Land areas on one scale, not two** — New Zealand listings quote land in hectares *or* square metres, so a 36 ha block sorts below a 1,671 m2 section in raw data. `landAreaSqm` restates every land area in square metres so you can genuinely sort, threshold and average it. It fills on 54% of listings overall and on 90-98% of section, lifestyle and rural searches, where land is the whole point.
- **Paste-a-URL or guided search** — drop in up to 50 Realestate.co.nz search or listing URLs, or describe what you want with the guided fields; one clean row per listing either way.

### Use Cases

**Property Investment & Analysis**

- Compare asking prices and weekly rents across regions and suburbs
- Estimate gross yields by pairing for-sale prices with rental data in the same suburb
- Track floor area and land area to find subdivision and development opportunities
- Map listings by latitude and longitude to spot pricing patterns street by street

**Lead Generation for Agents & Brokers**

- Build agent and agency contact lists with name, mobile, and email
- Identify the most active offices in a target district
- Source mortgage and insurance leads from fresh on-market listings
- Find newly listed properties to target with timely outreach

**Market Research & Valuation**

- Benchmark median prices across the eight listing categories
- Monitor commercial and rural inventory alongside residential
- Build comparables (comps) datasets for valuation and CMA reports
- Measure supply by region, district, and property type

**Relocation & Buyer Services**

- Shortlist properties by bedrooms, price, and suburb for relocating clients
- Collect open-home times to plan viewing routes across a weekend
- Compare lifestyle and rural options for sea-change and tree-change buyers
- Pull photo galleries and descriptions for client-ready summaries

**Proptech & Data Products**

- Feed structured New Zealand listing data into dashboards and apps
- Power price-alert and new-listing notification systems
- Enrich existing property databases with current pricing and media
- Build mapping and search tools on top of geo-tagged inventory

### Getting Started

#### Search a Region

The simplest start — pick a category and a region:

```json
{
    "searchType": "residential-sale",
    "region": "Auckland",
    "maxResults": 50
}
```

#### Filtered Search

Narrow to family homes in a price band:

```json
{
    "searchType": "residential-sale",
    "region": "Wellington",
    "propertyType": ["house", "townhouse"],
    "priceMin": 600000,
    "priceMax": 1200000,
    "bedroomsMin": 3,
    "maxResults": 200
}
```

#### Rental Search by Suburb

```json
{
    "searchType": "residential-rent",
    "region": "Auckland",
    "district": "Auckland City",
    "suburb": "Ponsonby",
    "priceMax": 800,
    "maxResults": 100
}
```

#### Paste Your Own URLs

Drop in any Realestate.co.nz search or listing URL straight from your browser:

```json
{
    "startUrls": [
        "https://www.realestate.co.nz/residential/sale/auckland",
        "https://www.realestate.co.nz/residential/rent/wellington"
    ],
    "maxResults": 300
}
```

### Input Reference

#### What to Scrape

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | string\[] | `[]` | Up to 50 Realestate.co.nz search, category, or individual listing URLs. The fastest way to get exactly the results you see on the site. When provided, the guided Build a Search fields are ignored. |

#### Build a Search

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchType` | select | `Residential for Sale` | Listing category: Residential for Sale, Residential for Rent, New Homes, Lifestyle, Rural, Commercial for Sale, Commercial for Lease, or Businesses for Sale. |
| `region` | string | `Auckland` | New Zealand region or area to search (e.g. "Auckland", "Wellington", "Canterbury", "Otago"). Leave empty to search all of New Zealand. |
| `district` | string | `null` | Optional district within the region (e.g. "Auckland City", "North Shore"). Leave empty to include the whole region. |
| `suburb` | string | `null` | Optional suburb within the district (e.g. "Ponsonby"). Leave empty to include the whole district. |

#### Filters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `propertyType` | select\[] | `[]` | One or more property types: House, Apartment, Townhouse, Unit, Studio, Section (land), Lifestyle property, Lifestyle section, Home & Income, Carpark. Empty = all types. The listing category you pick sets the boundary and this filter narrows within it, so choosing Lifestyle plus Lifestyle section returns only lifestyle sections. |
| `priceMin` | integer | `null` | Minimum price in NZD — total price when buying, weekly rent when renting. Empty = no minimum. Commercial for Lease listings are priced on application, so price filters don't apply there. |
| `priceMax` | integer | `null` | Maximum price in NZD. Empty = no maximum. Commercial for Lease listings are priced on application, so price filters don't apply there. |
| `bedroomsMin` | integer | `null` | Minimum bedrooms. Empty = any. |
| `bedroomsMax` | integer | `null` | Maximum bedrooms. Empty = any. |

#### Limits

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `100` | Maximum listings to collect per search or URL. Results come in full pages, so the final page may overshoot by a few rows — rows are never trimmed mid-page. Set to 0 for no cap (an internal safety limit of 50,000 then applies). |

### Output

Each listing is one clean row. This is a real record, exactly as the actor returned it (long photo list and description trimmed for space):

```json
{
    "id": "43101224",
    "title": "Near-New, Hill School Zone & Walk to Town",
    "url": "https://www.realestate.co.nz/43101224/residential/sale/45b-landscape-road-pukekohe",
    "searchCategory": "Residential for Sale",
    "searchType": "res_sale",
    "listingStatus": "active",
    "price": "Asking Price $899,000",
    "priceValue": 899000,
    "propertyType": "House",
    "bedrooms": 4,
    "bathrooms": 3,
    "garages": 1,
    "floorArea": 153,
    "floorAreaUnit": "sqm",
    "landArea": 244,
    "landAreaUnit": "SQM",
    "landAreaSqm": 244,
    "region": "Auckland",
    "district": "Franklin",
    "suburb": "Pukekohe",
    "address": "45B Landscape Road, Pukekohe",
    "latitude": -37.2079765,
    "longitude": 174.8945627,
    "listingDate": "2026-08-06T11:44:32+12:00",
    "agentName": "Ian du Plessis",
    "agencyName": "Port Realty Ltd (Licensed: REAA 2008) - Harcourts, Pukekohe",
    "agentPhone": "09 238 4244",
    "agentMobile": "0226414987",
    "agentEmail": "ian.duplessis@harcourts.co.nz",
    "photos": [
        "https://mediaserver.realestate.co.nz/listings/43101224/e8fcf74a3765dd0f5801778e431f21af.crop.1296x864.jpg",
        "https://mediaserver.realestate.co.nz/listings/43101224/f5bc5e84d39800ae2602d799ee155c52.crop.1296x864.jpg",
        "https://mediaserver.realestate.co.nz/listings/43101224/c8925b20d84f687e2c2f1b646dda604b.crop.1296x864.jpg"
    ],
    "openHomes": [
        { "start": "2026-08-29T13:00:00+12:00", "end": "2026-08-29T13:30:00+12:00" }
    ],
    "description": "<p>Built by Jennian Homes in 2024, this beautifully presented home combines contemporary style, quality craftsmanship, and an exceptional location...</p>",
    "searchQuery": "Residential for Sale in Auckland",
    "scrapedAt": "2026-08-28T10:47:40.180815+00:00"
}
```

Areas, coordinates, open-home times and agent details are only as complete as what each agency published, so several fields are deliberately left blank rather than filled with a fake zero. The **Filled** column below is the share of listings that actually carry a value, measured over 1,200 live listings from eight searches spanning residential sale and rent, lifestyle, sections, commercial property and businesses.

#### Core Fields

| Field | Type | Filled | Description |
|-------|------|--------|-------------|
| `id` | string | 100% | Realestate.co.nz listing identifier |
| `title` | string | 100% | Listing headline |
| `url` | string | 100% | Direct link to the listing on Realestate.co.nz |
| `searchCategory` | string | 100% | The category **you** searched, in the words the input uses: Residential for Sale, Residential for Rent, New Homes, Lifestyle, Rural, Commercial for Sale, Commercial for Lease or Businesses for Sale. Identical on every row of a run, so it is the column to filter or group a merged export on. |
| `searchType` | string | 100% | The **listing's own** category on Realestate.co.nz (`res_sale`, `res_rent`, `com_sale`, `com_lease`, `rural_sale`, `biz_sale`). This is the listing's label, not yours, so it can differ from `searchCategory` — a Lifestyle search returns a genuine mix of lifestyle homes filed under residential and under rural, and New Homes is a filter applied on top of residential for sale. |
| `listingStatus` | string | 100% | Listing status. On-market listings read `active` |
| `description` | string | 100% | The agency's own listing copy, kept as published, so it carries their HTML formatting (`<p>`, `<br />`) |
| `searchQuery` | string | 100% | Echo of the search that produced this row, e.g. `Residential for Sale in Auckland` |
| `scrapedAt` | string | 100% | ISO timestamp of data extraction, in UTC |

#### Address & Location

| Field | Type | Filled | Description |
|-------|------|--------|-------------|
| `region` | string | 100% | New Zealand region |
| `district` | string | 100% | District within the region |
| `suburb` | string | 92% | Suburb within the district. Businesses for sale are advertised without a street location, so they carry a region and district only |
| `address` | string | 94% | Display street address, e.g. `45B Landscape Road, Pukekohe`. Blank on businesses for the same reason |
| `latitude` | number | 88% | Latitude coordinate. 98% on residential sale, 81% on rentals, 18% on businesses |
| `longitude` | number | 88% | Longitude coordinate, filled whenever latitude is |

#### Price & Property Details

| Field | Type | Filled | Description |
|-------|------|--------|-------------|
| `price` | string | 100% | Price exactly as displayed: `Asking Price $899,000`, `$695 per week`, `Auction`, `Deadline Sale`, `Negotiation`, `POA` |
| `priceValue` | number | 47% | Clean numeric price in NZD, only when the display price holds a single figure. 100% on rentals; 37% on sale listings, because auction, deadline-sale and negotiation campaigns publish no number at all |
| `propertyType` | string | 100% | House, Apartment, Townhouse, Section, Lifestyle Property, Retail Property, and so on |
| `bedrooms` | number | 100% | Number of bedrooms. A genuine `0` is kept, so studios read 0 rather than blank |
| `bathrooms` | number | 74% | Number of bathrooms. Near-universal on homes and rentals, rare on bare sections, commercial premises and businesses |
| `garages` | number | 100% | Garage / car-space count, with a genuine `0` kept |
| `floorArea` | number | 42% | Floor area, blank when the agency did not publish one. 88% on commercial property, 48-72% on houses, 6% on businesses, and 0% on bare sections, which have no building to measure |
| `floorAreaUnit` | string | 40% | Unit for `floorArea`. Always `sqm` when present |
| `landArea` | number | 54% | Land area exactly as the listing publishes it, in whichever unit the agency chose. 90-99% on sections, lifestyle and rural listings; 3% on rentals |
| `landAreaUnit` | string | 54% | Unit that `landArea` is measured in: `SQM` (square metres) or `HA` (hectares) |
| `landAreaSqm` | number | 54% | Land area converted to square metres, so every row is on one scale. **Sort, filter and average on this field**, not on `landArea`. Blank on the rare listing that gives an area with no unit |
| `listingDate` | string | 100% | Date and time the listing was published, in New Zealand local time (`+12:00`, or `+13:00` in daylight saving) |

#### Agent, Agency, Media & Open Homes

| Field | Type | Filled | Description |
|-------|------|--------|-------------|
| `agentName` | string | 93% | Listing agent name. Near-universal on sale listings; 57% on rentals, where many are advertised by the office rather than a named person |
| `agencyName` | string | 99.8% | Listing agency / office name |
| `agentPhone` | string | 99.8% | The agent's listed landline or direct dial, falling back to the agency switchboard. This is a different number from `agentMobile` on 98% of listings |
| `agentMobile` | string | 93% | The agent's direct mobile, filled wherever `agentName` is |
| `agentEmail` | string | 93% | Agent email address, filled wherever `agentName` is |
| `photos` | string\[] | 100% | Full-resolution listing photo URLs at 1296×864, in display order. Typically 18 per listing, up to 94 |
| `openHomes` | object\[] | 49% | Upcoming open-home windows, each with `start` and `end` in New Zealand local time. 73% on residential for sale, near zero on rentals, commercial and businesses |

### Tips for Best Results

- **Start small** — set `maxResults` to 50-100 on your first run to confirm the data matches your needs, then scale up.
- **Match price to the category** — `priceMin` / `priceMax` are read as total price for sale categories and as weekly rent for rentals, so use ~$400–$1,500 ranges for rent and full property prices for sale. Commercial for Lease is advertised on application, so price limits do not narrow it.
- **Drill down with district and suburb** — supply `region` alone for a wide sweep, then add `district` and `suburb` to zoom in; the most specific location you give wins.
- **Estimate rental yield in one pass** — run a `residential-sale` search and a matching `residential-rent` search for the same suburb, then pair `priceValue` across both. Every rental publishes a weekly number, but only about a third of sale listings do, since auction and deadline-sale campaigns advertise no figure, so pull a wider sale sample than you think you need.
- **Paste URLs for exact parity** — copy the URL from your browser after filtering on the site to reproduce precisely what you see; pasted URLs override the guided fields.
- **Leave the region blank for nationwide coverage** — an empty `region` sweeps all of New Zealand, useful for category-wide market snapshots.
- **Pull agent contacts in bulk** — a phone number comes back on 99.8% of listings and the agent's name, mobile and email on 93%, making a single run an instant lead list for any target area. Sale searches give the richest contact data; rental stock is often advertised by the office instead of a named agent.
- **Grab a single listing fast** — paste an individual listing URL (the one with the property's number in the link) to pull just that one property as a clean row, no search needed.
- **Sort land on `landAreaSqm`, never on `landArea`** — lifestyle, rural and section searches routinely return a mix of hectare and square-metre listings, so `landArea` numbers are 10,000x apart in the same column. `landAreaSqm` puts them all in square metres, which is what you want for a "bigger than 5,000 m2" filter or any size ranking.
- **Expect blanks on floor and land area, and treat them as blanks** — agencies fill these in when they feel like it, so floor area lands on roughly 4 in 10 listings and land area on just over half. A missing area comes back empty rather than as a misleading `0`, so filter those rows out before you average or rank on size.

### Pricing

**From $1.00 per 1,000 results** — pay-per-result pricing that gets cheaper as your Apify subscription tier goes up. Prices below are the total cost for a run of that size.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.12 | $0.11 | $0.11 | $0.10 |
| 1,000 | $1.20 | $1.13 | $1.06 | $1.00 |
| 10,000 | $12.00 | $11.30 | $10.65 | $10.00 |
| 100,000 | $120.00 | $113.00 | $106.50 | $100.00 |

A "result" is any property listing row in the output dataset. No compute charges — you only pay per result returned. Gold-tier pricing stays at $1.00 per 1,000 results; the discount tiers above it take effect on 12 September 2026.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor is designed for legitimate real estate research, market analysis, and lead generation. Users are responsible for complying with applicable laws and Realestate.co.nz's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and handle any personal data such as agent contact details in line with New Zealand's Privacy Act and other relevant regulations.

# Actor input Schema

## `startUrls` (type: `array`):

Paste one or more Realestate.co.nz search, category, or individual listing URLs (for example https://www.realestate.co.nz/residential/sale/auckland). This is the fastest way to get exactly the results you see on the site. When you provide URLs here, the guided 'Build a Search' fields below are ignored.

## `searchType` (type: `string`):

Which kind of listings to search. New Homes returns newly built and under-construction properties only; Lifestyle returns lifestyle properties and lifestyle sections. Used only when no Search URLs are provided.

## `region` (type: `string`):

New Zealand region or area to search — for example 'Auckland', 'Wellington', 'Canterbury' or 'Otago'. Leave empty to search all of New Zealand.

## `district` (type: `string`):

Optional: a district within the selected region (for example 'Auckland City' or 'North Shore'). Leave empty to include the whole region.

## `suburb` (type: `string`):

Optional: a suburb within the selected district (for example 'Ponsonby'). Leave empty to include the whole district.

## `propertyType` (type: `array`):

Only include these property types. Select several to combine. Leave empty for all types. The Listing Category above sets the boundary and this filter narrows within it — picking Lifestyle plus 'Lifestyle section' returns only lifestyle sections, and a type that doesn't exist in the chosen category is reported in the run log rather than applied. Used only with the guided 'Build a Search' fields.

## `priceMin` (type: `integer`):

Only include listings at or above this price in New Zealand dollars — total price when buying, weekly rent when renting. Leave empty for no minimum. Note: Commercial for Lease listings are priced on application, so price filters don't apply to that category.

## `priceMax` (type: `integer`):

Only include listings at or below this price in New Zealand dollars. Leave empty for no maximum. Note: Commercial for Lease listings are priced on application, so price filters don't apply to that category.

## `bedroomsMin` (type: `integer`):

Only include listings with at least this many bedrooms. Leave empty for any number.

## `bedroomsMax` (type: `integer`):

Only include listings with at most this many bedrooms. Leave empty for any number.

## `maxResults` (type: `integer`):

Maximum number of listings to collect per search or URL. Use 50-100 for a quick scan or a higher number for deep research. Results are collected in full pages, so the final page may overshoot this number by a few rows — rows are never trimmed mid-page. Set to 0 for no cap (an internal safety limit of 50,000 is then applied).

## Actor input object example

```json
{
  "startUrls": [],
  "searchType": "residential-sale",
  "region": "Auckland",
  "propertyType": [],
  "maxResults": 100
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of scraped listings with the category you searched, the listing's own category, price, beds/baths, land area in square metres, location and URL.

## `detail` (type: `string`):

All extracted fields for every listing.

# 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 = {
    "startUrls": [],
    "searchType": "residential-sale",
    "region": "Auckland",
    "propertyType": [],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/realestate-co-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 = {
    "startUrls": [],
    "searchType": "residential-sale",
    "region": "Auckland",
    "propertyType": [],
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/realestate-co-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 '{
  "startUrls": [],
  "searchType": "residential-sale",
  "region": "Auckland",
  "propertyType": [],
  "maxResults": 100
}' |
apify call solidcode/realestate-co-nz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,solidcode/realestate-co-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/oXP2WTkBojIaHz4OX/builds/dPhGNL8efNajFLHFG/openapi.json