OneRoof Data Parser & API

OneRoof is a major New Zealand property portal owned by NZME (publisher of the NZ Herald) and a key player in the NZ three-way portal contest — and PropAPIS extracts its resale, rental and new-build listings with agent, photo, geo and suburb data through a single REST API. Cover Auckland, Wellington, Christchurch and the wider NZ market without building or maintaining a scraper.

Platform Overview

Market Position

• A major NZ portal contesting the market against Trade Me Property and Realestate.co.nz
• Owned by NZME, the publisher of the New Zealand Herald
• NZME announced a strategic review of OneRoof in early 2025 (possible part-sale, separation or listing)
• Competes directly with the Trade Me + Stuff Digital JV in the NZ property-ad war

Market Coverage

Geographic Coverage:

• Auckland, Wellington and Christchurch
• Hamilton, Tauranga, Dunedin and regional NZ
• Suburb-level coverage nationwide

Property Types:

• Houses and Apartments / Units
• Townhouses and Lifestyle blocks
• New-build and developments

Data Availability

OneRoof exposes residential listing fields plus suburb and estimate data — agent and agency info, photos, geo and sold data — at Medium anti-bot difficulty with no official public API (an unofficial parse path), which PropAPIS handles for you.

Listing Categories:

• Buy: Resale and ready-to-move NZ properties
• Rent: Long-term residential rentals
• New homes: New-build and developer projects
• Sold / Estimates: Sold prices and suburb value data

Data Fields Available

PropAPIS extracts structured data from each OneRoof listing:

Property Information

• Address: Street, suburb, region and postcode
• Price: Sale price, price guide or rent
• Bedrooms, Bathrooms and Car Spaces
• Property Type: House, apartment, townhouse
• Area: Floor area and land size
• Estimate: OneRoof value estimate where shown

Listing Details

• Description: Full listing text
• Photos: Image URLs
• Features and amenities
• Listed / Updated date

Agent Information

• Agency: Agency name and branch
• Agent: Listing agent name
• Agent Contact: Phone where published

Location & Market Data

• Suburb and Region
• Coordinates: Latitude and longitude
• Sold Data: Recent sales nearby
• Suburb Insights: Median price and trends

API Endpoints

Get Property Details

from propapis import PropAPIS
 
api = PropAPIS(api_key='your_api_key')
 
# Get a OneRoof listing by URL or ID
property_data = api.platforms.oneroof.get_property(
    listing_id='12345678'
)
 
print(f"Title: {property_data.title}")
print(f"Price: NZD {property_data.price:,}")
print(f"Suburb: {property_data.suburb}")

Search Listings

# Search OneRoof listings
listings = api.platforms.oneroof.search(
    region='Auckland',
    suburb='Remuera',
    purpose='for-sale',
    min_bedrooms=3,
    property_type='House'
)
 
for listing in listings[:10]:
    print(f"{listing.title} - NZD {listing.price:,}")
    print(f"  {listing.bedrooms} bed | {listing.suburb}")

Search Sold Data

# Search recently sold NZ properties
sold = api.platforms.oneroof.search_sold(
    region='Canterbury',
    suburb='Merivale'
)
 
for sale in sold[:5]:
    print(f"{sale.address} - sold NZD {sale.sold_price:,} on {sale.sold_date}")

Quick Start

from propapis import PropAPIS
 
api = PropAPIS(api_key='your_api_key')
 
# Search OneRoof listings in Auckland
listings = api.platforms.oneroof.search(region='Auckland', purpose='for-sale')
 
for listing in listings[:5]:
    print(f"{listing.title} - NZD {listing.price:,}")

import { PropAPIS } from 'propapis';
 
const api = new PropAPIS({ apiKey: 'your_api_key' });
 
// Search OneRoof listings in Auckland
const listings = await api.platforms.oneroof.search({
  region: 'Auckland',
  purpose: 'for-sale',
});
 
listings.slice(0, 5).forEach((l) => {
  console.log(`${l.title} - NZD ${l.price.toLocaleString()}`);
});

curl "https://api.propapis.com/v1/platforms/oneroof/search?region=Auckland&purpose=for-sale" \
  -H "Authorization: Bearer your_api_key"

Frequently asked questions

Related platforms