# Realestate Property Details Scraper (`alexist/realestate-property-details-scraper`) Actor

Scrape comprehensive property listings from Realestate.co.nz with precision. Collect 50+ data points including bedrooms, price, photos, virtual tours, school zones, and listing status — essential for real estate professionals, investors, and market researchers.

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

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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

## Real Estate Property Details Scraper: Extract NZ Property Data at Scale

***

### What Is Realestate.co.nz?

Realestate.co.nz is New Zealand's leading residential property portal, hosting thousands of active listings across residential, rental, and commercial segments. It provides detailed property information including descriptions, photos, floor plans, virtual walkthroughs, and neighborhood context. Manually extracting this data across multiple properties is tedious and error-prone — the **Real Estate Property Details Scraper** automates extraction, delivering structured records ready for analysis.

***

### Overview

The **Real Estate Property Details Scraper** extracts rich property information from individual Realestate.co.nz listing pages, capturing 50+ data points per property. It is built for:

- **Real estate agents** and brokerages tracking market inventory
- **Property investors** conducting market research and comparative analysis
- **Developers** monitoring competitor listings and pricing trends
- **Data analysts** building property market datasets and dashboards
- **Price aggregators** feeding property data into third-party platforms

Key features include configurable maximum items per URL, graceful failure handling via `ignore_url_failures`, and comprehensive extraction of media assets (photos, floor plans, virtual tours), property attributes (bedrooms, bathrooms, parking), and listing metadata (dates, status, agent info).

***

### Input Format

The scraper accepts a JSON configuration specifying which property URLs to scrape:

```json
{
    "urls": [
        "https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
        "https://www.realestate.co.nz/43091544/residential/sale/10-burns-street-leamington",
        "https://www.realestate.co.nz/43091182/residential/sale/24a-scarborough-terrace-hanmer-springs"
    ],
    "max_items_per_url": 200,
    "ignore_url_failures": true
}
```

| Parameter | Description |
|---|---|
| `urls` | Array of direct links to individual property listings on Realestate.co.nz |
| `max_items_per_url` | Maximum number of records to extract per URL (typically 200 for full property details) |
| `ignore_url_failures` | Boolean flag. If `true`, scraper continues on failed URLs; if `false`, stops on first failure |

**Tips:**

- Paste individual property detail page URLs (not search results pages)
- Each URL must be a complete Realestate.co.nz listing with full property ID
- Use bulk edit to paste multiple URLs at once from a prepared list

***

### Output Format

**Sample output**

```json
{
  "title_type": 1,
  "parking_garage_count": 1,
  "study_count": 0,
  "videos": [],
  "is_new_construction": true,
  "other_features": [],
  "photos": [
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/c4479ba063860773d7545a8c2a2a56cc",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771721,
      "medium": ".crop.105x134.jpg",
      "uuid": "26e6e07b-4224-4a4a-9e5d-2a754444e0de",
      "md5": "c4479ba063860773d7545a8c2a2a56cc",
      "order": 1
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/ed0a8053bb36e20a7d35b6e6428cf35b",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771722,
      "medium": ".crop.105x134.jpg",
      "uuid": "fcbd0edd-9721-4f15-8060-458b36de9232",
      "md5": "ed0a8053bb36e20a7d35b6e6428cf35b",
      "order": 2
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/a0f616ae4a0018e435fa7c382f36db76",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771725,
      "medium": ".crop.105x134.jpg",
      "uuid": "1ccf8176-c3ae-4f86-ad1e-45a726a75958",
      "md5": "a0f616ae4a0018e435fa7c382f36db76",
      "order": 3
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/23347a2dc25e40db1b5e157a17d55b0c",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771728,
      "medium": ".crop.105x134.jpg",
      "uuid": "663d2e55-4f7c-4f1d-91c6-e2e91d49aefd",
      "md5": "23347a2dc25e40db1b5e157a17d55b0c",
      "order": 4
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/76f4f63b8d9049265b6563115d03428e",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771727,
      "medium": ".crop.105x134.jpg",
      "uuid": "1c590acb-f9a9-4818-9c05-e99822085fc7",
      "md5": "76f4f63b8d9049265b6563115d03428e",
      "order": 5
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/b8a12ca5ee3e00b4f43e39060548b9c2",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771724,
      "medium": ".crop.105x134.jpg",
      "uuid": "a1828975-fbd8-4fdb-834b-12632aaf67b0",
      "md5": "b8a12ca5ee3e00b4f43e39060548b9c2",
      "order": 6
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/df6956d9eb58b1886e5df4cd39f48798",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771723,
      "medium": ".crop.105x134.jpg",
      "uuid": "c47b5e0c-ffc9-4865-bc60-e62292d394cf",
      "md5": "df6956d9eb58b1886e5df4cd39f48798",
      "order": 7
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/d4db2dff3cff1cc378c272556df35233",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771731,
      "medium": ".crop.105x134.jpg",
      "uuid": "35b5edc9-4b1e-43ca-abf7-02e3895d9b07",
      "md5": "d4db2dff3cff1cc378c272556df35233",
      "order": 8
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/6af51b8f64fab20b3552a6ca4a3c7b4c",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771733,
      "medium": ".crop.105x134.jpg",
      "uuid": "b7e7e336-9769-43c1-b617-d3d1f702af3f",
      "md5": "6af51b8f64fab20b3552a6ca4a3c7b4c",
      "order": 9
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/2b236a288110c5eef71564f6dfdaaf01",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771734,
      "medium": ".crop.105x134.jpg",
      "uuid": "2f821ff1-9e22-4e48-a050-e19a36b1ad04",
      "md5": "2b236a288110c5eef71564f6dfdaaf01",
      "order": 10
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/566349677f914d446fc8b211f164aa91",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771736,
      "medium": ".crop.105x134.jpg",
      "uuid": "62e8fecd-d625-447a-8cea-1b13eb752463",
      "md5": "566349677f914d446fc8b211f164aa91",
      "order": 11
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/323ffdd9e009fc3ce1289d37d7f98b60",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771737,
      "medium": ".crop.105x134.jpg",
      "uuid": "f3b9a59f-4f98-4dd7-9f72-bc4ddc721c76",
      "md5": "323ffdd9e009fc3ce1289d37d7f98b60",
      "order": 12
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/fb61198c9de2bddb7a5edd29338bbfb7",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771738,
      "medium": ".crop.105x134.jpg",
      "uuid": "7ce2a321-b50c-4715-80b9-c95ada56254b",
      "md5": "fb61198c9de2bddb7a5edd29338bbfb7",
      "order": 13
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/3dd2d94553269c45ec68050fa84ec5ed",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771739,
      "medium": ".crop.105x134.jpg",
      "uuid": "59b6043c-c56f-4934-a3b9-459424942efa",
      "md5": "3dd2d94553269c45ec68050fa84ec5ed",
      "order": 14
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/1717e89a18c4a4f62fa81eed5254a622",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771741,
      "medium": ".crop.105x134.jpg",
      "uuid": "39936802-2785-4577-af2a-3909d373b4df",
      "md5": "1717e89a18c4a4f62fa81eed5254a622",
      "order": 17
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/77b6ec171f0336a6c4e451840a6f8dac",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771730,
      "medium": ".crop.105x134.jpg",
      "uuid": "a0e9de2a-a73a-4286-baf4-c041c3acf4a8",
      "md5": "77b6ec171f0336a6c4e451840a6f8dac",
      "order": 18
    },
    {
      "small": ".crop.70x89.jpg",
      "base-url": "/listings/43091286/ee5103d26a9d7e060bca8bb467b39f82",
      "square": ".crop.110x110.jpg",
      "thumbnail": ".crop.31x40.jpg",
      "large": ".crop.140x178.jpg",
      "id": 659771740,
      "medium": ".crop.105x134.jpg",
      "uuid": "b06dc394-7805-4db5-86e7-89477d5609fc",
      "md5": "ee5103d26a9d7e060bca8bb467b39f82",
      "order": 19
    }
  ],
  "is_featured": true,
  "is_private_listing": false,
  "living_area_count": 0,
  "features": {
    "garages": 0,
    "bedrooms": 0,
    "storey-count": 0,
    "bathroom-wc-count": 0,
    "pool": false,
    "carports": 0,
    "ensuite": 0,
    "bathrooms": 0,
    "other-features": {},
    "carpark-other": 0
  },
  "virtual_walkthroughs": [],
  "listing_type": 1,
  "bathrooms_total_count": 3,
  "is_refresh": true,
  "floorplans": [],
  "bathroom_wc_count": 0,
  "has_swimming_pool": false,
  "additional_websites": [
    {
      "title": "here",
      "type": "additional-website",
      "url": "https://www.barfoot.co.nz/937987?ref=realestate",
      "order": 0
    }
  ],
  "broadbands": [],
  "schools": [],
  "call_to_action_links": [],
  "parking_covered_count": 0,
  "header": "Move-In Ready Home in Popular Stanmore Bay",
  "land_area": 134,
  "website_full_url": "https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
  "listing_category_code": "res_sale",
  "description": "<p>Discover contemporary living at Lot 32, 55 Rimurehia Rise, Stanmore Bay — a brand-new home offering a relaxed coastal lifestyle in a thoughtfully designed community. Perfectly positioned in the heart of Stanmore Bay, this home combines modern comfort, quality finishes, and convenient access to beaches, schools, shopping, and transport links.<br /><br />Featuring a well-designed layout with three bedrooms, including a master suite, and 2.5 bathrooms, this home provides comfortable living for families, professionals, or those seeking a low-maintenance lifestyle. The open-plan kitchen, dining, and living area create a welcoming space for everyday living, while the private deck and easy-care garden provide the perfect setting to relax and entertain.<br /><br />Property Features:<br /></p><br />\n<ul><li>Brand-new home in a sought-after coastal community</li><li>3 bedrooms, including 2 master suites</li><li>3 bathrooms</li><li>Open-plan kitchen with quality appliances and practical layout</li><li>Spacious open-plan living and dining area</li><li> Private deck</li><li>Designed for modern, easy-care living</li></ul><br /><br />\n<p>Community Amenities:<br /></p><br />\n<ul><li>Residents can enjoy a range of shared facilities within the development, including:</li><li>Party House</li><li>Children’s playground</li><li>Multi-purpose sports court</li><li>BBQ area</li><li>Scenic walking paths</li></ul><br /><br />\n<p>Location Highlights:<br /></p><br />\n<ul><li>Approximately 7 minutes to Silverdale Shopping Centre</li><li>Approximately 10 minutes to the future Penlink connection, providing improved access to Albany and Auckland CBD</li><li>Close to beautiful beaches, all within approximately 10 minutes’ drive</li></ul><br /><br />\n<p>Nearby Education Options:<br /></p><br />\n<ul><li>Red Beach School</li><li>Stanmore Bay School</li><li>Wentworth Primary School</li><li>Wentworth College</li></ul><br /><br />\n<p>An excellent opportunity to secure a brand-new home in a growing coastal community, offering modern design, convenient amenities, and an enviable Stanmore Bay location. Call us today to arrange a viewing!</p>",
  "parking_other_count": 0,
  "is_showcased": true,
  "published_date": "2026-07-22T12:53:46+12:00",
  "bedroom_count": 3,
  "deferred_share_url": "https://realestateconz.smart.link/egenyff2o?link=https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay&apn=nz.co.realestate.android&ibi=nz.co.realestate.realestate&isi=404076057",
  "listing_sub_type": "Townhouse",
  "listing_no": "937987",
  "is_coastal_waterfront": false,
  "bathroom_ensuite_count": 0,
  "is_super_featured": true,
  "price_display": "Negotiation",
  "storey_count": 0,
  "address": {
    "suburb-fq-slug": "auckland_rodney_stanmore-bay_stanmore-bay",
    "country": "New Zealand",
    "full-address": "Lot 32, 55 Rimurehia Rise, Stanmore Bay, Rodney, Auckland",
    "nearby-suburbs-fq-slugs": [
      "auckland_rodney_red-beach",
      "auckland_rodney_manly",
      "auckland_rodney_arkles-bay"
    ],
    "region-fq-slug": "auckland",
    "district-slug": "rodney",
    "display": true,
    "suburb-slug": "stanmore-bay",
    "accuracy": 0,
    "region-slug": "auckland",
    "suburb-display-slug": "stanmore-bay",
    "district-fq-slug": "auckland_rodney",
    "suburb-display": "Stanmore Bay",
    "street": "Rimurehia Rise",
    "street-number": "Lot 32, 55",
    "suburb-display-fq-slug": "auckland_rodney_stanmore-bay",
    "district": "Rodney",
    "suburb": "Stanmore Bay",
    "sdnid": 337,
    "display-address": "Lot 32, 55 Rimurehia Rise, Stanmore Bay",
    "region": "Auckland",
    "street-name": "Rimurehia Rise",
    "pub-address-web": true,
    "nearby-suburbs": [
      "red-beach",
      "manly",
      "arkles-bay"
    ]
  },
  "max_tenants": 0,
  "price_history": [],
  "land_area_unit": "SQM",
  "bathroom_full_count": 3,
  "created_date": "2026-07-22T12:53:42+12:00",
  "price_code": 3,
  "open_homes": [
    {
      "start": "2026-07-25T12:00:00+12:00",
      "end": "2026-07-25T12:30:00+12:00"
    },
    {
      "start": "2026-07-26T12:00:00+12:00",
      "end": "2026-07-26T12:30:00+12:00"
    }
  ],
  "listing_status": "active",
  "show_agent_photo": true,
  "website_slug": "/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
  "is_mortgagee_sale": false,
  "hide_avm": false,
  "bathroom_count": 3,
  "relationships": null
}
```

Each property record includes 50+ structured fields organized by category:

#### Listing Identification & Status

| Field | Description |
|---|---|
| `Listing No` | Unique Realestate.co.nz property ID |
| `Website Slug` | URL-friendly property identifier |
| `Website Full URL` | Complete listing page URL |
| `Listing Type` | Property category (e.g., residential, rental, commercial) |
| `Listing Sub Type` | Specific property type (e.g., house, apartment, condo) |
| `Listing Status` | Current status (active, sold, withdrawn) |
| `Is Featured` | Whether listing has featured placement |
| `Is Super Featured` | Whether listing has premium featured status |
| `Is Showcased` | Whether property is showcased in search results |
| `Is Refresh` | Recently refreshed/relisted flag |
| `Is Private Listing` | Privacy restricted flag |
| `Published Date` | When listing went live |
| `Created Date` | When record was created |

#### Property Attributes

| Field | Description |
|---|---|
| `Bedroom Count` | Total number of bedrooms |
| `Bathroom Count` | Total bathroom fixtures |
| `Bathroom Full Count` | Fully-equipped bathrooms |
| `Bathroom Ensuite Count` | Ensuite bathrooms attached to master bedroom |
| `Bathroom WC Count` | Water closet/toilet-only rooms |
| `Living Area Count` | Number of separate living spaces |
| `Study Count` | Dedicated study or office rooms |
| `Storey Count` | Number of building levels/floors |
| `Land Area` | Property size (numeric value) |
| `Land Area Unit` | Unit of measurement (typically square meters) |

#### Parking & Garage

| Field | Description |
|---|---|
| `Parking Garage Count` | Enclosed garage spaces |
| `Parking Covered Count` | Covered but open parking spaces |
| `Parking Other Count` | Other parking arrangements (carport, driveway) |

#### Features & Amenities

| Field | Description |
|---|---|
| `Has Swimming Pool` | Boolean indicating pool presence |
| `Is Coastal Waterfront` | Waterfront property flag |
| `Is New Construction` | Brand new home flag |
| `Is Mortgagee Sale` | Mortgagee or forced sale flag |
| `Features` | Comma-separated feature list (e.g., deck, renovated, alarm) |
| `Other Features` | Additional amenities and upgrades |

#### Media Assets

| Field | Description |
|---|---|
| `Photos` | Array of photo URLs and metadata |
| `Floorplans` | Floor plan image URLs and details |
| `Videos` | Video listing URLs |
| `Virtual Walkthroughs` | 360° or virtual tour links |

#### Pricing & Financial

| Field | Description |
|---|---|
| `Price Display` | Displayed asking price or "Contact Agent" |
| `Price Code` | Internal price encoding (exact, range, negotiable) |
| `Price History` | Array of past price changes and dates |
| `Hide AVM` | Flag to hide automated valuation model |

#### Location & Connectivity

| Field | Description |
|---|---|
| `Address` | Full street address of the property |
| `Schools` | Nearby schools within catchment zones |
| `Broadbands` | Available broadband providers and speeds |
| `Max Tenants` | Maximum allowed tenants (for rentals) |

#### Agent & Display

| Field | Description |
|---|---|
| `Show Agent Photo` | Whether agent profile photo displays |
| `Call To Action Links` | Agent contact and inquiry links |
| `Additional Websites` | Links to agent websites or portals |
| `Header` | Property header/headline text |
| `Description` | Full property description |
| `Deferred Share URL` | Share-ready deferred link |
| `Open Homes` | Scheduled open inspection times and dates |
| `Relationships` | Related property records or similar listings |

***

### How to Use

1. **Identify properties** — Navigate to Realestate.co.nz and find property listings you wish to extract. Copy individual property URLs (not search pages).

2. **Prepare input list** — Paste URLs into the `urls` array. Example:
   ```
   https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay
   https://www.realestate.co.nz/43091544/residential/sale/10-burns-street-leamington
   ```

3. **Configure settings** — Set `max_items_per_url` to `200` for complete property detail extraction. Enable `ignore_url_failures: true` for robust bulk runs.

4. **Execute the scrape** — Start the scraper and monitor progress via run logs.

5. **Export data** — Download results as JSON, CSV, or Excel for analysis in spreadsheets, databases, or BI tools.

**Best practices:**

- Verify URLs point to property detail pages, not agent profiles or search results
- For large runs (50+ URLs), enable failure tolerance to prevent interruptions
- Use the Bulk edit feature to paste pre-formatted URL lists

***

### Use Cases & Business Value

- **Market analysis:** Track property prices, features, and listing duration by suburb or region
- **Investment research:** Compare properties across neighborhoods for investment decisions
- **Competitive intelligence:** Monitor competitor listings, pricing strategies, and inventory levels
- **Data science:** Build datasets for price prediction models or market trend analysis
- **CRM integration:** Feed property data into customer relationship systems for personalized follow-up

The Real Estate Property Details Scraper eliminates manual listing collection, enabling rapid market research and data-driven decision-making for agents, investors, and analysts.

***

### Conclusion

The **Real Estate Property Details Scraper** transforms Realestate.co.nz listings into machine-readable data across 50+ fields. Whether you're monitoring market trends, conducting investment analysis, or powering a third-party platform, this scraper delivers reliable, structured property intelligence at scale.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific property urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## Actor input object example

```json
{
  "urls": [
    "https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
    "https://www.realestate.co.nz/43091544/residential/sale/10-burns-street-leamington",
    "https://www.realestate.co.nz/43091182/residential/sale/24a-scarborough-terrace-hanmer-springs",
    "https://www.realestate.co.nz/43091502/residential/sale/54-the-avenue-lynfield",
    "https://www.realestate.co.nz/43091525/residential/sale/1-denz-street-maeroa"
  ],
  "ignore_url_failures": true
}
```

# 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 = {
    "urls": [
        "https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
        "https://www.realestate.co.nz/43091544/residential/sale/10-burns-street-leamington",
        "https://www.realestate.co.nz/43091182/residential/sale/24a-scarborough-terrace-hanmer-springs",
        "https://www.realestate.co.nz/43091502/residential/sale/54-the-avenue-lynfield",
        "https://www.realestate.co.nz/43091525/residential/sale/1-denz-street-maeroa"
    ],
    "ignore_url_failures": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/realestate-property-details-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 = {
    "urls": [
        "https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
        "https://www.realestate.co.nz/43091544/residential/sale/10-burns-street-leamington",
        "https://www.realestate.co.nz/43091182/residential/sale/24a-scarborough-terrace-hanmer-springs",
        "https://www.realestate.co.nz/43091502/residential/sale/54-the-avenue-lynfield",
        "https://www.realestate.co.nz/43091525/residential/sale/1-denz-street-maeroa",
    ],
    "ignore_url_failures": True,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/realestate-property-details-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 '{
  "urls": [
    "https://www.realestate.co.nz/43091286/residential/sale/lot-32-55-rimurehia-rise-stanmore-bay",
    "https://www.realestate.co.nz/43091544/residential/sale/10-burns-street-leamington",
    "https://www.realestate.co.nz/43091182/residential/sale/24a-scarborough-terrace-hanmer-springs",
    "https://www.realestate.co.nz/43091502/residential/sale/54-the-avenue-lynfield",
    "https://www.realestate.co.nz/43091525/residential/sale/1-denz-street-maeroa"
  ],
  "ignore_url_failures": true
}' |
apify call alexist/realestate-property-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=alexist/realestate-property-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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