🏠 OneRoof Search Scraper This actor allows you to scrape property listings from OneRoof.co.nz by providing a search URL. It automatically handles pagination and extracts comprehensive property information including images, addresses, bedrooms, bathrooms, parking, agent details, and company information. ## Features - URL-based Scraping: Extract property listings by providing a complete OneRoof search URL - Automatic Pagination: Automatically clicks through pages and loads more listings until reaching the end or max items limit - Comprehensive Property Data: Extract detailed information about each property including: - Property URLs and images - Full addresses - Auction information and timings - Bedrooms, bathrooms, and parking spaces - Agent names and avatars - Real estate company logos and names - Smart Deduplication: Automatically removes duplicate listings based on property URLs - Proxy Support: Optional proxy configuration for enhanced reliability ## Input Parameters | Field | Type | Required | Description | |------------|---------|----------|------------------------------------------------| | searchUrl| string | Yes | Complete OneRoof search URL to scrape | | maxItems | integer | No | Maximum number of listings to fetch (default: unlimited) | | proxyConfiguration | object | No | Proxy settings for the actor | ### How to Get Search URL 1. Go to OneRoof.co.nz 2. Use the search filters to find properties (location, property type, price range, etc.) 3. Copy the complete URL from your browser's address bar 4. Paste it into the searchUrl field Example search URL: https://www.oneroof.co.nz/search/houses-for-sale/district_hastings-hawkes-bay-247_page_1 ## Output The output is a dataset of property listing objects, each containing: - searchUrl: The original search URL used - url: Direct link to the property detail page - address: Full property address - auction: Auction information or timing - beds: Number of bedrooms - baths: Number of bathrooms - cars: Number of parking spaces - image: URL of the property cover image - agentName: Name of the listing agent - agentAvatar: URL of the agent's profile photo - companyLogo: URL of the real estate company logo - companyName: Name of the real estate company - scrapedAt: Timestamp of when the listing was scraped Example output: json [ { "searchUrl": "https://www.oneroof.co.nz/search/houses-for-sale/district_hastings-hawkes-bay-247_page_1", "url": "https://www.oneroof.co.nz/property/hawkes-bay/havelock-north/16-brookvale-road/pcsPU", "address": "16 Brookvale Road, Havelock North, Hastings", "auction": "1", "beds": "3", "baths": "1", "cars": "1", "image": "https://s.oneroof.co.nz/image/c7/ab/c7abd5be4899ed80cba49cd0858cfa79.jpg?x-oss-process=image/quality,q_80/resize,w_1200/format,webp", "agentName": "Nate Skelton", "agentAvatar": "", "companyLogo": "https://s.oneroof.co.nz/image/3b/29/3b291efc7b46be09a66f4c4058daf534.jpg?x-oss-process=image/quality,q_80/resize,w_640/format,webp", "companyName": "Eastern Realty Ltd (Licensed: REAA 2008) - Bayleys, Havelock North", "scrapedAt": "2025-11-06T09:11:01.261Z" }, ... ] ## Use Cases - Real estate market research in New Zealand - Property price analysis and comparison - Lead generation for real estate professionals - Investment opportunity tracking - Market trend analysis by region - Agent performance monitoring - Competitive analysis for real estate agencies - Property inventory tracking ## Notes - The actor works specifically with OneRoof New Zealand (oneroof.co.nz) - Results are saved incrementally as they are found - All timestamps are in ISO 8601 format - The actor handles network delays and timeouts gracefully - Proxy configuration is optional but recommended for large-scale scraping - Some agent avatars may not be available for all listings ## Proxy Configuration For enhanced reliability, you can configure proxy settings: json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } --- Start scraping New Zealand property listings from OneRoof today!