Real Estate NZ Agents Scraper

Extract comprehensive data from Real Estate New Zealand agent listings with ease.

This powerful Apify Actor scrapes real estate agent profiles from realestate.co.nz, New Zealand's leading property marketplace. Extract contact details, listing statistics, office information, and more in seconds.

🔗 Related Scrapers: Need property listings? Check out our Real Estate NZ Listings Scraper | Looking for Canadian real estate agents? Try our Realtor.ca Agents Scraper

👨‍💻 Built by ScrapeMind - Web scraping expert with 5+ years of experience using Go, Python, and TypeScript. Focused on building efficient and reliable data extraction tools.

Key Features

• Fast & Efficient: Concurrent request handling for rapid data extraction
• Comprehensive Data: Agent details, contact info, listing counts, office details, and more
• Flexible Scraping: Single page, specific search, or full database scrape (up to 10,000 agents)
• URL-Based Input: Simply paste Real Estate NZ URLs - no complex configuration needed
• Complete Office Data: Includes office contact details, addresses, branding, and more
• Ready-to-Use Output: Clean, structured JSON data ready for CRM, marketing, or analysis

What Data Do You Get?

Agent Information

• Identification: Agent ID, full name, first name, last name, slug
• Contact Details: Email, mobile phone, office phone
• Profile: High-quality photo URL, profile URL, biography
• Specialties: Languages spoken, area specialties
• Performance: Total listings, sale listings, rent listings, sold listings

Office Information

• Identity: Office ID, full name, colloquial name (e.g., "Ray White - Papatoetoe"), slug
• Contact: Phone, rental phone, fax, email, website URL
• Branding: Office logo image, brand color hex code, brand color lightness flag
• Addresses: Complete physical and postal addresses with city, region, and country details

Use Cases

Real Estate Professionals

• Lead Generation: Build targeted lists of agents for partnerships or networking
• Market Research: Analyze agent performance and market presence by region
• Competitive Analysis: Track agent listing volumes and activity

Marketing & Sales Teams

• Contact Lists: Create comprehensive databases for B2B outreach
• CRM Integration: Import agent data directly into your CRM system
• Email Campaigns: Build targeted email lists with verified contact information

Data Analysts & Researchers

• Market Analysis: Study real estate market trends by agent and office
• Geographic Distribution: Map agent locations and specialties across New Zealand
• Performance Metrics: Analyze listing counts and agent success rates

Software Developers

• Property Platforms: Integrate agent data into property search applications
• Comparison Tools: Build tools that compare agents and their performance
• API Development: Create APIs that serve real estate agent data

How to Use

Input Configuration

Option 1: URL-Based Scraping (Recommended)

Simply provide Real Estate NZ agent search URLs. You can scrape multiple searches in a single run:

{
  "startUrls": [
    {
      "url": "https://www.realestate.co.nz/search/results/agents/smith"
    },
    {
      "url": "https://www.realestate.co.nz/search/results/agents/auckland"
    },
    {
      "url": "https://www.realestate.co.nz/search/results/agents/ray-white"
    }
  ]
}

The scraper automatically extracts:

• Search query from the URL path (e.g., "smith", "auckland", "ray-white")
• Page number from the query parameter (e.g., 1)
• Processes all URLs sequentially, combining results into one dataset

Option 2: Multiple Searches with Full Scrape

Combine multiple URLs with fullScrape to extract all agents for each search:

{
  "startUrls": [
    {
      "url": "https://www.realestate.co.nz/search/results/agents/auckland"
    },
    {
      "url": "https://www.realestate.co.nz/search/results/agents/wellington"
    }
  ],
  "fullScrape": true
}

This will scrape all agents matching "auckland" AND all agents matching "wellington" (up to 10,000 per search).

Option 3: Manual Configuration

Configure search and pagination manually:

{
  "searchQuery": "john",
  "page": 1,
  "fullScrape": false
}

Input Parameters

Parameter	Type	Description
startUrls	Array	Multiple URLs to scrape. Format: https://www.realestate.co.nz/search/results/agents/{query}?page={number}. All URLs are processed sequentially.
searchQuery	String	Alternative to startUrls. Search by agent name or keyword (single search only)
page	Integer	Page number to scrape (default: 1, only used when fullScrape is false)
fullScrape	Boolean	Scrape all available results for each URL with concurrent pagination (default: false)
proxyConfiguration	Object	Apify proxy settings for anti-bot protection (requires paid plan)

URL Format Requirements

The scraper validates URLs to ensure correct format:

✅ Valid URLs:

• https://www.realestate.co.nz/search/results/agents/smith
• https://www.realestate.co.nz/search/results/agents/auckland?page=2
• https://www.realestate.co.nz/search/results/agents/ray-white

❌ Invalid URLs:

• Wrong domain: https://example.com/agents/smith
• Incorrect path: https://www.realestate.co.nz/agents/smith
• Missing search query: https://www.realestate.co.nz/search/results/agents

Output Format

The Actor outputs structured JSON data for each agent:

{
  "agentId": "123456",
  "name": "John Smith",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john.smith@raywhite.com",
  "phoneMobile": "021 123 4567",
  "phoneOffice": "09 123 4567",
  "image": "http://mediaserver.realestate.co.nz/agent/123456.crop.1660x.jpg",
  "slug": "john-smith-ray-white-auckland",
  "profileUrl": "https://www.realestate.co.nz/agent/john-smith-ray-white-auckland",
  "listingCount": 45,
  "saleListingCount": 30,
  "rentListingCount": 10,
  "soldListingCount": 120,
  "bio": "Experienced real estate agent specializing in Auckland suburbs...",
  "languages": ["English", "Mandarin"],
  "areaSpecialties": ["Auckland City", "North Shore"],
  "office": {
    "id": "299483",
    "name": "Noble Realty Ltd (Licensed: REAA 2008) - Ray White, Auckland",
    "colloquialName": "Ray White - Auckland",
    "slug": "ray-white-auckland",
    "image": "http://mediaserver.realestate.co.nz/office/299483.crop.1660x.jpg",
    "brandHexCode": "#FFE512",
    "isBrandColourLight": true,
    "phone": "09 123 4567",
    "phoneRental": "021 987 6543",
    "fax": "09 123 4568",
    "email": "auckland.nz@raywhite.com",
    "websiteUrl": "http://www.rwauckland.co.nz",
    "physicalAddress": {
      "address1": "123 Queen Street",
      "address3": "Auckland Central",
      "city": "Auckland",
      "country": "New Zealand",
      "countryCode": "NZ"
    },
    "postalAddress": {
      "address1": "PO Box 12345",
      "address3": "Auckland Central",
      "city": "Auckland",
      "country": "New Zealand",
      "countryCode": "NZ"
    }
  }
}

Performance & Limits

• Single Page: ~1-2 seconds per page (12 agents)
• Full Scrape: ~30-60 seconds for 10,000 agents per URL (with concurrent requests)
• Multiple URLs: Processed sequentially, time scales linearly with number of URLs
• Concurrency: Up to 5 concurrent requests in full scrape mode
• Maximum Agents: 10,000 agents per search query (API limitation)
• Rate Limiting: Built-in respect for server load with controlled concurrency

Best Practices

1. Use Full Scrape Wisely: Enable fullScrape only when you need complete datasets
2. Multiple Searches: Combine related searches in one run (e.g., different cities or agency brands) to maximize efficiency
3. Specific Searches: Use targeted search queries (e.g., location names, agent surnames) for faster results
4. Error Handling: If one URL fails, the scraper continues with remaining URLs automatically
5. Proxy Configuration: Enable Apify Proxy for high-volume scraping to avoid blocks
6. Data Storage: Use Apify's dataset storage for automatic deduplication and easy export
7. Export Formats: Export data to CSV, JSON, Excel, or connect to your database

Common Search Examples

Search by Agent Name

https://www.realestate.co.nz/search/results/agents/smith

Search by Location

https://www.realestate.co.nz/search/results/agents/auckland
https://www.realestate.co.nz/search/results/agents/wellington

Search by Agency Brand

https://www.realestate.co.nz/search/results/agents/ray-white
https://www.realestate.co.nz/search/results/agents/harcourts

Search by Letters (Alphabetical Browsing)

https://www.realestate.co.nz/search/results/agents/a
https://www.realestate.co.nz/search/results/agents/ab

Technical Details

API Source

This Actor extracts data from Real Estate NZ's official platform API:

• Endpoint: https://platform.realestate.co.nz/search/v1/agents
• Format: JSON:API specification
• Data: Real-time agent and office information

Data Accuracy

• Source: Official Real Estate NZ platform API
• Freshness: Real-time data directly from the source
• Completeness: All publicly available agent information
• Validation: Comprehensive URL and data validation

Troubleshooting

"Invalid URL" Error

Ensure your URL follows the format: https://www.realestate.co.nz/search/results/agents/{searchQuery}

No Results Found

• Check if the search query matches any agents on the website
• Try broader search terms (e.g., single letters or location names)
• Verify the URL is accessible in your browser

Slow Performance

• Consider using fullScrape: false for specific pages
• Enable Apify Proxy to improve connection stability
• Check your Apify plan limits and memory allocation

Related Scrapers

Looking for more real estate data extraction tools?

• Real Estate NZ Listings Scraper - Extract property listings from realestate.co.nz including prices, features, photos, and agent details for residential and commercial properties across New Zealand
• Realtor.ca Agents Scraper - Extract comprehensive realtor data from Realtor.ca including contact details, office information, and social media links for real estate professionals across Canada

Support & Development

Need Help?

We're here to help! For questions, custom scraping solutions, or support:

• Email: baqo271@gmail.com
• Website: scrapeminds.com
• GitHub: B9UU
• LinkedIn: ibrahim-boussaa

Custom Solutions

Need a custom scraper or automation tool? ScrapeMind offers:

• 🛠️ Custom scraping tools tailored to your specific extraction needs
• ⚡ Automation solutions for data collection processes
• 🚀 Performance optimization for efficient and accurate data extraction

With 5+ years of experience in Go, Python, and TypeScript, we build efficient and reliable data extraction tools.

Integration Examples

• Export to Google Sheets for easy sharing and collaboration
• Connect to Zapier for automated workflows
• Use webhooks to push data to your applications in real-time
• Integrate with Make (formerly Integromat) for complex automations

Keywords

Real Estate NZ, realestate.co.nz, New Zealand real estate agents, property agents, agent scraper, real estate data, agent contact details, office information, listing statistics, lead generation, market research, CRM data, agent profiles, property professionals, NZ real estate market, agent database, real estate leads, contact scraping, business intelligence, sales prospecting

Version History

v1.0.0

• Initial release with full agent and office data extraction
• URL-based input with automatic parsing
• Full scrape mode with concurrent pagination
• Comprehensive office details including addresses and branding
• Input validation and error handling