OneRoof Property Search Scraper: Extract NZ Real Estate Data at Scale

---

What Is OneRoof.co.nz?

OneRoof.co.nz is New Zealand's largest and most trusted property portal, listing residential and commercial real estate across the country. With hundreds of thousands of active listings, it serves as the primary marketplace for home buyers, renters, and investors. Collecting property data manually is labor-intensive and error-prone — the OneRoof Property Search Scraper automates extraction, delivering structured datasets ideal for market analysis, investment research, and integration into custom platforms.

---

Overview

The OneRoof Property Search Scraper extracts comprehensive property details from OneRoof search result pages, transforming listings into clean, machine-readable records. It captures everything from basic details (bedrooms, bathrooms, price) to advanced metadata (AVM valuations, project information, agent details, and high-resolution images).

Ideal for:

• Real estate investors tracking market trends by region, price band, and property type
• Data analysts building NZ property datasets for research and benchmarking
• Property aggregator platforms feeding licensed data into custom portals
• Market researchers monitoring listing velocity, pricing patterns, and inventory health
• Developers building property search APIs or comparison tools

Strengths include flexible URL filtering, configurable item limits, robust error handling, and rich output spanning property attributes, images, pricing, location data, and agent information.

---

Input Format

The scraper accepts a JSON configuration to control the collection scope:

{
  "urls": [
    "https://www.oneroof.co.nz/search/houses-for-sale/region_all-new-zealand-1_bedroom_2_order_latest-0_property-type_house-1_page_2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Field	Type	Description
urls	Array of strings	Direct links to OneRoof search result pages (filtered by region, property type, price, bedrooms, etc.). URLs can include query parameters for refined searches.
max_items_per_url	Integer	Maximum number of properties to extract per URL. Set to 200 for comprehensive collection or lower values for targeted sampling.
ignore_url_failures	Boolean	If true, the scraper skips failed URLs and continues running. If false, it stops on the first failure. Recommended: true for large-scale runs.

Best practice: Customize OneRoof search URLs using their filter interface (region, property type, price range, bedrooms, sort order) before pasting into the scraper. This reduces data noise and speeds collection.

---

Output Format

Sample output

{
  "id": 2469857,
  "uid": "62pIN",
  "slug": "central-otago-lakes-district/alexandra/29b-station-street/62pIN",
  "is_carousel": false,
  "is_premium": false,
  "listing_type_id": 1,
  "type_id": 1,
  "teaser": "Modern, Chic, Practical",
  "brief": "",
  "images": [
    "https://s.oneroof.co.nz/image/1f/77/1f7717515bcdbc3b98aff57570410b07.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/24/17/241763163bab02f30c5af540ebfd22b8.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/d0/f0/d0f0124013d4f2c8aaa0c6b9924dee0a.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/a4/29/a429e0a73032de23e8e5021e9c505ddf.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/67/e0/67e0dad0fc7d98eec90fb4697f7766bc.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/a9/48/a948bcea08c5bd56c77b2146e787018f.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/41/e3/41e3768d891f26c431d5c9ff93e1c1c3.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/56/07/5607a294e123840e739e566917483bfc.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/06/aa/06aa45ed09a89875c1151b3b807b31c4.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/90/59/905972ae2a25fe0393733e9d7880beda.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/cf/1e/cf1e60fff27d2d03c561dc627da7b86f.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/09/62/0962e1671e9c2ec12bb7fe214d6815fa.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/a7/55/a7550317b4b931c80f75163a3bf2eaa5.jpg?x-oss-process=image/quality,q_80",
    "https://s.oneroof.co.nz/image/c1/70/c17024a046be4e628d66f04c149421a1.jpg?x-oss-process=image/quality,q_80"
  ],
  "image_tag_tidy": [
    {
      "key": "living room",
      "label": "Living Room",
      "images": [
        "https://s.oneroof.co.nz/image/24/17/241763163bab02f30c5af540ebfd22b8.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/d0/f0/d0f0124013d4f2c8aaa0c6b9924dee0a.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a4/29/a429e0a73032de23e8e5021e9c505ddf.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/67/e0/67e0dad0fc7d98eec90fb4697f7766bc.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/cf/1e/cf1e60fff27d2d03c561dc627da7b86f.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a7/55/a7550317b4b931c80f75163a3bf2eaa5.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "kitchen",
      "label": "Kitchen",
      "images": [
        "https://s.oneroof.co.nz/image/24/17/241763163bab02f30c5af540ebfd22b8.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/d0/f0/d0f0124013d4f2c8aaa0c6b9924dee0a.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a4/29/a429e0a73032de23e8e5021e9c505ddf.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a9/48/a948bcea08c5bd56c77b2146e787018f.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "bedroom",
      "label": "Bedroom",
      "images": [
        "https://s.oneroof.co.nz/image/41/e3/41e3768d891f26c431d5c9ff93e1c1c3.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/06/aa/06aa45ed09a89875c1151b3b807b31c4.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "bathroom",
      "label": "Bathroom",
      "images": [
        "https://s.oneroof.co.nz/image/56/07/5607a294e123840e739e566917483bfc.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/90/59/905972ae2a25fe0393733e9d7880beda.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "real estate exterior",
      "label": "Exterior",
      "images": [
        "https://s.oneroof.co.nz/image/1f/77/1f7717515bcdbc3b98aff57570410b07.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a4/29/a429e0a73032de23e8e5021e9c505ddf.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/cf/1e/cf1e60fff27d2d03c561dc627da7b86f.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/09/62/0962e1671e9c2ec12bb7fe214d6815fa.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a7/55/a7550317b4b931c80f75163a3bf2eaa5.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "aerial shot",
      "label": "Aerial View",
      "images": [
        "https://s.oneroof.co.nz/image/09/62/0962e1671e9c2ec12bb7fe214d6815fa.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "floor plan",
      "label": "Floor Plan",
      "images": [
        "https://s.oneroof.co.nz/image/c1/70/c17024a046be4e628d66f04c149421a1.jpg?x-oss-process=image/quality,q_80"
      ]
    },
    {
      "key": "other room",
      "label": "Others",
      "images": [
        "https://s.oneroof.co.nz/image/1f/77/1f7717515bcdbc3b98aff57570410b07.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/1f/77/1f7717515bcdbc3b98aff57570410b07.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/24/17/241763163bab02f30c5af540ebfd22b8.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/d0/f0/d0f0124013d4f2c8aaa0c6b9924dee0a.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/67/e0/67e0dad0fc7d98eec90fb4697f7766bc.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/67/e0/67e0dad0fc7d98eec90fb4697f7766bc.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a9/48/a948bcea08c5bd56c77b2146e787018f.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/41/e3/41e3768d891f26c431d5c9ff93e1c1c3.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/41/e3/41e3768d891f26c431d5c9ff93e1c1c3.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/06/aa/06aa45ed09a89875c1151b3b807b31c4.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/06/aa/06aa45ed09a89875c1151b3b807b31c4.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/cf/1e/cf1e60fff27d2d03c561dc627da7b86f.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/09/62/0962e1671e9c2ec12bb7fe214d6815fa.jpg?x-oss-process=image/quality,q_80",
        "https://s.oneroof.co.nz/image/a7/55/a7550317b4b931c80f75163a3bf2eaa5.jpg?x-oss-process=image/quality,q_80"
      ]
    }
  ],
  "property_image_from_house_id": 0,
  "oss_images": [],
  "floor_plan_images": [],
  "detail_images": [],
  "new_house": false,
  "price_method": 13,
  "price_bold": "Enquiries Over $749,000",
  "price_light": null,
  "auction": null,
  "open_homes": {
    "times": [
      {
        "id": 72172316,
        "start": "1781397000",
        "end": "1781398800",
        "is_added": false,
        "link": null,
        "zoom_id": null,
        "platforms": null
      }
    ]
  },
  "online_open_homes": null,
  "online_auctions": null,
  "showroom": null,
  "showroom_time": null,
  "type": "Residential for sale",
  "category": "House",
  "category_id": 1,
  "category_logo": "",
  "sub_category": "",
  "sub_category_id": null,
  "has_saved_search": false,
  "is_favourite": false,
  "enquired": false,
  "is_viewed": false,
  "tracked": false,
  "bedrooms": 2,
  "bathrooms": 2,
  "carspaces": 2,
  "underline_color": "#000000",
  "font_color": "#000000",
  "bg_color": "#ffffff",
  "button_color": "#000000",
  "landarea": 335,
  "land_area_unit": 1,
  "land_area_string": "335m²",
  "floorarea": null,
  "floor_area_unit": 1,
  "floor_area_string": null,
  "publish_address": true,
  "suburb_name": "Alexandra",
  "suburb_id": 4184,
  "district_id": 287,
  "region_id": 50,
  "street": "29B Station Street",
  "suburb": "Alexandra",
  "district": "Central Otago",
  "region": "Central Otago/Lakes District",
  "market_time": 1781024400,
  "new_listing": true,
  "lng": 169.395322,
  "lat": -45.2470318,
  "is_recommended": false,
  "is_showcase": false,
  "is_showcase_repeat": null,
  "is_project": false,
  "village_type": 0,
  "project_status": null,
  "is_ready": false,
  "is_land_home": false,
  "ad": null,
  "code": "L41168323",
  "video": "https://www.youtube.com/watch?v=pcY1HJugjic",
  "video_id": "pcY1HJugjic",
  "status": 1,
  "self_listing": true,
  "my_note": null,
  "three_dview": null,
  "share_link": "https://www.oneroof.co.nz/property/central-otago-lakes-district/alexandra/29b-station-street/62pIN",
  "agents": [
    {
      "id": 99894,
      "icon": "https://s.oneroof.co.nz/image/82/72/8272b5d74c007c843d7ce76abbd402db.jpg?x-oss-process=image/quality,q_80",
      "name": "Rhys Chamberlain",
      "phone_number": "0272013172"
    },
    {
      "id": 119529,
      "icon": "https://s.oneroof.co.nz/image/0f/94/0f9487791d641baf87c04427d79bfb6e.jpg?x-oss-process=image/quality,q_80",
      "name": "Renee Suszko",
      "phone_number": "0277234443"
    }
  ],
  "office": {
    "id": 11034,
    "name": "Raine & Horne Alexandra | Cromwell",
    "icon": "https://s.oneroof.co.nz/image/53/a8/53a8500d13402d86b733fabd5014e847.png?x-oss-process=image/quality,q_80",
    "hero_pic": "https://s.oneroof.co.nz/image/50/18/5018b0e6997fbd202f7670983957aee2.jpg?x-oss-process=image/quality,q_80",
    "underline_color": "#000000",
    "font_color": "#000000",
    "bg_color": "#ffffff",
    "button_color": "#000000"
  },
  "tags": [],
  "houses_of_project": [],
  "project_of_house": null,
  "avm": {
    "avm": "$$730,000",
    "high": "$$810,000",
    "low": "$$645,000",
    "rv": "$$700,000",
    "confidence": 3.5,
    "show_avm": true,
    "avm_rv_rate": "left",
    "confidence_score": "High",
    "suburb_month_sale_price12": "$$823,616",
    "suburb_avg_rv": "$$802,426",
    "suburb_sale_rvdiff": 2.64
  },
  "rv": "$$700,000",
  "rv_time": 1756641600,
  "building_age": "2019",
  "median_sale_price": null,
  "updated": null,
  "last_view_time": null,
  "property_floor_area": null,
  "property_land_area": null,
  "village_logo_detail": null,
  "village_logo_bottom": null,
  "village_contact_email": null,
  "village_contact_phone": null,
  "village_second_contact_email": null,
  "village_second_contact_phone": null,
  "village_contact_name": null,
  "village_second_contact_name": null,
  "village_link": null,
  "village_color_bottom": null,
  "nzme_info": null,
  "available_floor_plans": [],
  "unit_order": [],
  "living_options": [],
  "is_coming_soon": false,
  "available_date": null,
  "from_url": "https://www.oneroof.co.nz/search/houses-for-sale/region_all-new-zealand-1_bedroom_2_order_latest-0_property-type_house-1_page_2"
}

Each property returns a comprehensive record with 100+ fields:

Core Identification

Field	Meaning
ID	Unique internal OneRoof property identifier
UID	Alternate unique identifier for cross-referencing
Slug	URL-friendly property identifier
Code	Listing code assigned by the agent or OneRoof
Status	Current listing status (active, sold, withdrawn, etc.)

Listing Type & Promotion

Field	Meaning
Listing Type ID	Categorization of the listing type
Type ID	Property transaction type (sale, rent, etc.)
Is Carousel	Whether the property has a carousel image gallery
Is Premium	Premium/featured listing flag
Is Showcase	Featured showcase placement on OneRoof
Is Showcase Repeat	Repeated showcase promotion
New Listing	Flag indicating a recently added listing
Is Coming Soon	Whether the property is coming soon but not live
Available Date	Date when the property becomes available (for rentals/projects)

Property Attributes & Specifications

Field	Meaning
Bedrooms	Number of bedrooms
Bathrooms	Number of bathrooms
Carspaces	Number of car parking spaces
Type	Property type (house, apartment, townhouse, section, etc.)
Category	Property category
Category ID	Numeric ID for the category
Sub Category	Detailed property subcategory
Sub Category ID	Numeric ID for the subcategory
New House	Whether this is a new build property
Is Land Home	Whether the listing includes land-only or home + land
Is Ready	Ready-to-occupy flag for new properties
Building Age	Age of the building structure

Pricing Information

Field	Meaning
Price Method	How price is displayed (fixed, auction, tender, etc.)
Price Bold	Prominent price display value
Price Light	Secondary/lighter price information
Median Sale Price	Comparable median price for the area
AVM	Automated Valuation Model (estimated property value)
RV	Rateable Value (council assessment)
RV Time	Last update timestamp for RV
Auction	Whether property is going to auction
Online Auctions	Online auction event details
Online Open Homes	Virtual open home scheduled

Size & Area Details

Field	Meaning
Land Area	Plot/land size value
Land Area Unit	Unit of measurement (sqm, hectares)
Land Area String	Human-readable land area text
Floor Area	Building floor area
Floor Area Unit	Floor area unit (sqm)
Floor Area String	Human-readable floor area text
Property Floor Area	Calculated floor area for standardization
Property Land Area	Calculated land area for standardization

Location & Geography

Field	Meaning
Publish Address	Street address displayed in the listing
Street	Street name only
Suburb Name	Suburb/locality name
Suburb ID	Suburb numeric identifier
Suburb	Full suburb information object
District	District/city name
District ID	District numeric identifier
Region	Region/state name (e.g., Auckland, Canterbury)
Region ID	Region numeric identifier
Latitude	Geographic latitude coordinate
Longitude	Geographic longitude coordinate
Market Time	Time listed on the OneRoof market

Images & Media

Field	Meaning
Images	Array of property image URLs and metadata
Image Tag Tidy	Categorized image tags (kitchen, bedroom, etc.)
Property Image From House ID	Reference to the originating property ID
OSS Images	Overseas/international property images
Floor Plan Images	Floor plan diagrams and URLs
Detail Images	High-resolution detail photos
Video	Video listing URLs if available
Video ID	Video platform identifier
3D View	3D tour or virtual walkthrough link

Agent & Office Information

Field	Meaning
Agents	Real estate agent name(s) and contact details
Office	Real estate office/agency information
Self Listing	Flag if property is self-listed (no agent)
My Note	Agent notes or internal annotations

Description & Content

Field	Meaning
Teaser	Short property headline/teaser text
Brief	Brief property description
Enquired	Whether the viewer has inquired about the property
Is Viewed	Flag indicating if user has viewed this property
Is Favourite	Favorite/watchlist status flag
Tracked	Whether property price or status changes are tracked
Has Saved Search	If property matches a saved search
Is Recommended	OneRoof's recommendation algorithm flag

Project & Development Properties

Field	Meaning
Is Project	Whether the listing is a project/development
Project Status	Development project status (planning, under construction, completed)
Project Of House	Project metadata for this property
Houses Of Project	Related properties in the same project
Village Type	Village/retirement village type
Available Floor Plans	Available floor plan options (for projects)
Unit Order	Unit/lot order number in a project

Open Homes & Viewings

Field	Meaning
Open Homes	Scheduled physical open home times
Showroom	Whether property has a showroom facility
Showroom Time	Showroom opening hours or scheduled times

Styling & Branding

Field	Meaning
Underline Color	Custom listing color (underline)
Font Color	Custom font color for listing
Background Color	Custom background color
Button Color	Custom button color for listing
Category Logo	Logo associated with the property category

Tags & Classifications

Field	Meaning
Tags	User-generated or system tags (pet-friendly, renovated, etc.)
Living Options	Lifestyle/living options available

Metadata & Administrative

Field	Meaning
Updated	Last update timestamp for the listing
Last View Time	When the property was last viewed
Share Link	Shareable URL for the property
Ad	Advertisement/promotion metadata

Additional Data (Village/Project Contacts)

Field	Meaning
Village Logo Detail	Village community logo (detailed version)
Village Logo Bottom	Village logo (bottom placement)
Village Contact Email	Primary village contact email
Village Contact Phone	Primary village contact phone
Village Contact Name	Primary contact person name
Village Second Contact Email	Secondary contact email
Village Second Contact Phone	Secondary contact phone
Village Second Contact Name	Secondary contact person name
Village Link	Link to village/project website
Village Color Bottom	Village branding color

Additional Metadata

Field	Meaning
NZME Info	New Zealand Media & Entertainment related metadata

---

How to Use

1. Build your search URL — Use OneRoof.co.nz's advanced search interface to filter by region, property type, price range, bedrooms, and sort order. Copy the resulting URL.

   Example filters:

   • Region: All New Zealand / Specific region (Auckland, Wellington, etc.)
   • Property type: Houses, apartments, sections, commercial
   • Price range: Minimum and maximum price
   • Bedrooms: 1+, 2+, 3+, etc.
   • Sort: Latest, price (high to low), price (low to high)

2. Paste URLs — Add one or more search result URLs to the urls array. You can scrape multiple searches in one run.

3. Configure limits — Set max_items_per_url based on your needs:

   • 20–50: Quick samples or specific searches
   • 100–200: Comprehensive regional datasets
   • Higher values for market-wide collections

4. Enable error handling — Set ignore_url_failures: true for robustness. This allows the scraper to skip broken links and continue.

5. Run the scraper — Start the actor and monitor progress. Results appear in JSON, CSV, or Excel format.

6. Export & analyze — Download the dataset and import into spreadsheets, databases, or BI tools for further analysis.

Tips:

• Pagination: OneRoof URLs include page numbers. Modify page parameters to collect multiple pages in sequence, or scrape one page at a time.
• Filtering: Use OneRoof filters to narrow results. Narrow searches are faster and return more relevant data.
• Rate limiting: For large-scale runs, monitor for temporary blocks and use delays between requests if needed.

---

Use Cases & Business Value

• Investment analysis: Track property prices, market time, and inventory by region and property type
• Market intelligence: Monitor competitor listings, pricing strategies, and market velocity
• Market research: Analyze NZ property market trends, affordability, supply/demand patterns
• Data products: Feed property data into custom search platforms, comparison tools, or investment apps
• Portfolio management: Track properties matching specific investment criteria (price, location, age)
• Valuation benchmarking: Compare AVM and RV estimates across comparable properties
• Development tracking: Monitor new projects and their progress toward completion

The OneRoof Property Search Scraper eliminates weeks of manual research, providing actionable datasets that power smarter investment and market decisions.

---

Conclusion

The OneRoof Property Search Scraper unlocks the full value of New Zealand's largest property dataset. With over 100 data fields per property — spanning pricing, location, imagery, and agent details — it enables investors, researchers, and platform developers to build data-driven strategies and products. Start scraping today and transform OneRoof listings into competitive intelligence.