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: json { "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: json { "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: json { "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: json { "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