🏠 RealEstate.co.nz Listings Scraper

This actor allows you to scrape property listings from RealEstate.co.nz by providing a search URL. It automatically handles pagination and extracts comprehensive property information including prices, property details, agent information, and images.

Features

• URL-based Scraping: Extract property listings by providing a complete RealEstate.co.nz search URL
• Automatic Pagination: Automatically scrolls and loads more listings until reaching the end or max items limit
• Comprehensive Property Data: Extract detailed information about each property including:
  • Property address and title
  • Price information
  • Property type and features (bedrooms, bathrooms, carparks, land area)
  • Agent information and photos
  • Office logos
  • Property images and gallery
  • Listing date and status
  • Promoted status and open home availability
• Rich Media: Includes property images, agent photos, and office logos
• Property Details: Track property features, pricing, and availability

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete RealEstate.co.nz search URL to scrape
maxItems	integer	No	Maximum number of listings to fetch

Output

The output is a main list of property listing objects, each containing:

• searchUrl: The original search URL used
• listingId: Unique identifier for the listing
• detailUrl: URL to the detailed property page
• address: Property address
• title: Property title or description
• price: Price information
• propertyType: Type of property (e.g., House, Apartment)
• bedrooms: Number of bedrooms
• bathrooms: Number of bathrooms
• carparks: Number of carparks
• landArea: Land area information
• agents: Array of agent names
• agentPhotos: Array of agent photo URLs
• officeLogo: Office logo URL
• listedDate: Date when the property was listed
• mainImage: Main property image URL
• gallery: Array of property image URLs
• extraPhotoCount: Number of additional photos
• promoted: Whether the listing is promoted
• openHome: Whether there is an open home scheduled
• scrapedAt: Timestamp of when the listing was scraped

Example output:

[
  {
    "searchUrl": "https://www.realestate.co.nz/residential/sale/wellington",
    "listingId": "42932644",
    "detailUrl": "https://www.realestate.co.nz/42932644/residential/sale/45-donovan-road-paraparaumu-beach",
    "address": "45 Donovan Road, Paraparaumu Beach",
    "title": "Love at First Sight - Act Fast!",
    "price": "Tender",
    "propertyType": "House",
    "bedrooms": "3",
    "bathrooms": "1",
    "carparks": null,
    "landArea": "1012m2",
    "agents": [
      "Awatea Martell"
    ],
    "agentPhotos": [
      "https://mediaserver.realestate.co.nz/per_orgs/1861071/9641ac3410433d51d787981d2d3169ce.fcrop.90x90.jpg"
    ],
    "officeLogo": "https://mediaserver.realestate.co.nz/per_orgs/3437/041f1a8f2c43f4d5d75b3fb15e5b9681.scale.125x.jpg",
    "listedDate": "now",
    "mainImage": "https://mediaserver.realestate.co.nz/listings/42932644/598eda1d0a04fbd5cfef7bdbba5d1378.crop.658x493.jpg?options=compress",
    "gallery": [
      "https://mediaserver.realestate.co.nz/listings/42932644/598eda1d0a04fbd5cfef7bdbba5d1378.crop.658x493.jpg?options=compress"
    ],
    "extraPhotoCount": 17,
    "promoted": true,
    "openHome": true,
    "scrapedAt": "2025-11-20T03:39:22.754Z"
  }
]

Use Cases

• Property market research and analysis
• Price tracking and comparison
• Real estate investment research
• Property listing aggregation
• Market trend analysis

Notes

• Results are automatically paginated until reaching the end or max items limit
• All property details are extracted from the listing pages
• Images and media are included in the output
• Agent and office information is captured for each listing