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

\[💰 $1.0 / 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:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 name, mobile, and email on every record. 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.
- **Listing agent contact on every record** — agent name, direct mobile, and email, plus the agency office name, captured for each listing so you get a ready-to-use lead list.
- **Up to ~34 full-resolution photos per listing** — every gallery image rebuilt at full 1296×864 resolution, ordered as shown on the site, not thumbnail-sized previews.
- **Open-home schedules with start and end times** — each upcoming viewing window returned as a structured start/end pair, ideal for relocation planning and agent monitoring.
- **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.
- **Geo coordinates and structured areas on every listing** — latitude, longitude, floor area with unit, and land area with unit, ready for mapping and valuation models.
- **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. |
| `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. Here's a representative result:

```json
{
    "id": "4501234",
    "title": "Sun-Drenched Family Home in the Heart of Ponsonby",
    "url": "https://www.realestate.co.nz/4501234/residential/sale/12-jervois-road-ponsonby",
    "searchType": "res_sale",
    "listingStatus": "live",
    "price": "Enquiries over $1,850,000",
    "priceValue": 1850000,
    "propertyType": "House",
    "bedrooms": 4,
    "bathrooms": 2,
    "garages": 1,
    "floorArea": 180,
    "floorAreaUnit": "m2",
    "landArea": 405,
    "landAreaUnit": "m2",
    "region": "Auckland",
    "district": "Auckland City",
    "suburb": "Ponsonby",
    "address": "12 Jervois Road, Ponsonby, Auckland",
    "latitude": -36.8485,
    "longitude": 174.7445,
    "listingDate": "2026-05-14T09:00:00Z",
    "agentName": "Sarah Thompson",
    "agencyName": "Barfoot & Thompson Ponsonby",
    "agentPhone": "021 555 0123",
    "agentMobile": "021 555 0123",
    "agentEmail": "sarah.thompson@barfoot.co.nz",
    "photos": [
        "https://mediaserver.realestate.co.nz/listings/4501234/abc123.crop.1296x864.jpg"
    ],
    "openHomes": [
        { "start": "2026-05-31T11:00:00Z", "end": "2026-05-31T11:30:00Z" }
    ],
    "description": "Beautifully renovated villa moments from Ponsonby Road...",
    "searchQuery": "residential-sale / Auckland",
    "scrapedAt": "2026-05-30T14:30:00Z"
}
```

#### Core Fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Realestate.co.nz listing identifier |
| `title` | string | Listing headline |
| `url` | string | Direct link to the listing on Realestate.co.nz |
| `searchType` | string | Category the listing came from (e.g. res\_sale, res\_rent) |
| `listingStatus` | string | Listing status (e.g. live) |
| `description` | string | Listing description text |
| `searchQuery` | string | Echo of the search or URL that produced this row |
| `scrapedAt` | string | ISO timestamp of data extraction |

#### Address & Location

| Field | Type | Description |
|-------|------|-------------|
| `region` | string | New Zealand region |
| `district` | string | District within the region |
| `suburb` | string | Suburb within the district |
| `address` | string | Display street address |
| `latitude` | number | Latitude coordinate |
| `longitude` | number | Longitude coordinate |

#### Price & Property Details

| Field | Type | Description |
|-------|------|-------------|
| `price` | string | Price as displayed (e.g. "Enquiries over $1,850,000", "$650/week") |
| `priceValue` | number | Clean numeric price in NZD when a single figure is parseable |
| `propertyType` | string | House, Apartment, Townhouse, etc. |
| `bedrooms` | number | Number of bedrooms |
| `bathrooms` | number | Number of bathrooms |
| `garages` | number | Garage / car-space count |
| `floorArea` | number | Floor area value |
| `floorAreaUnit` | string | Unit for floor area (e.g. m2) |
| `landArea` | number | Land area value |
| `landAreaUnit` | string | Unit for land area (e.g. m2, ha) |
| `listingDate` | string | Date the listing was published |

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

| Field | Type | Description |
|-------|------|-------------|
| `agentName` | string | Listing agent name |
| `agencyName` | string | Listing agency / office name |
| `agentPhone` | string | Agent contact phone |
| `agentMobile` | string | Agent direct mobile |
| `agentEmail` | string | Agent email address |
| `photos` | string\[] | Full-resolution listing photo URLs, in display order |
| `openHomes` | object\[] | Upcoming open-home windows, each with `start` and `end` times |

### 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.
- **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 to gauge gross yield.
- **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** — every listing carries the agent's name, mobile, and email, making a single run an instant lead list for any target area.
- **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.

### Pricing

**$1.00 per 1,000 results** — flat, simple pay-per-result pricing for fresh New Zealand listing data.

| Results | Estimated Cost |
|---------|----------------|
| 100 | $0.10 |
| 1,000 | $1.00 |
| 10,000 | $10.00 |
| 100,000 | $100.00 |

A "result" is any property listing row in the output dataset. No compute charges — you only pay per result returned.

### 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. 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. 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 price, beds/baths, area, 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/realestate-co-nz-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Realestate.co.nz Scraper",
        "description": "[💰 $1.0 / 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.",
        "version": "1.0",
        "x-build-id": "bPu2wbxbEqq9EEDFp"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solidcode~realestate-co-nz-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solidcode-realestate-co-nz-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/solidcode~realestate-co-nz-scraper/runs": {
            "post": {
                "operationId": "runs-sync-solidcode-realestate-co-nz-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/solidcode~realestate-co-nz-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-solidcode-realestate-co-nz-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "startUrls": {
                        "title": "Search URLs",
                        "maxItems": 50,
                        "type": "array",
                        "description": "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.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchType": {
                        "title": "Listing Category",
                        "enum": [
                            "residential-sale",
                            "residential-rent",
                            "new-homes",
                            "lifestyle",
                            "rural",
                            "commercial-sale",
                            "commercial-lease",
                            "business"
                        ],
                        "type": "string",
                        "description": "Which kind of listings to search. Used only when no Search URLs are provided.",
                        "default": "residential-sale"
                    },
                    "region": {
                        "title": "Region",
                        "type": "string",
                        "description": "New Zealand region or area to search — for example 'Auckland', 'Wellington', 'Canterbury' or 'Otago'. Leave empty to search all of New Zealand."
                    },
                    "district": {
                        "title": "District",
                        "type": "string",
                        "description": "Optional: a district within the selected region (for example 'Auckland City' or 'North Shore'). Leave empty to include the whole region."
                    },
                    "suburb": {
                        "title": "Suburb",
                        "type": "string",
                        "description": "Optional: a suburb within the selected district (for example 'Ponsonby'). Leave empty to include the whole district."
                    },
                    "propertyType": {
                        "title": "Property Type",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Only include these property types. Select several to combine. Leave empty for all types. Used only with the guided 'Build a Search' fields.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "house",
                                "apartment",
                                "townhouse",
                                "unit",
                                "studio",
                                "section",
                                "lifestyle",
                                "lifestyle-section",
                                "home-income",
                                "carpark"
                            ],
                            "enumTitles": [
                                "House",
                                "Apartment",
                                "Townhouse",
                                "Unit",
                                "Studio",
                                "Section (land)",
                                "Lifestyle property",
                                "Lifestyle section",
                                "Home & Income",
                                "Carpark"
                            ]
                        },
                        "default": []
                    },
                    "priceMin": {
                        "title": "Minimum Price (NZD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "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": {
                        "title": "Maximum Price (NZD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "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": {
                        "title": "Minimum Bedrooms",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include listings with at least this many bedrooms. Leave empty for any number."
                    },
                    "bedroomsMax": {
                        "title": "Maximum Bedrooms",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include listings with at most this many bedrooms. Leave empty for any number."
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "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).",
                        "default": 100
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
