realestate.co.nz API & Scraper
The realestate.co.nz API returns New Zealand's industry-run property portal as clean JSON, in NZD.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search returns up to 100 listings a page - homes for sale or for rent, rural, commercial and business - filtered by region, district or one or more suburbs (by name or id), price, bedrooms, bathrooms, land and floor area, car parks, property type, sale method (auction, tender, deadline sale, negotiation, asking price, enquiries over), keyword, open homes, new builds, coastal, pools, pets and furnishing for rentals, or one agent or agency. Every row carries the listing's realestate.co.nz URL, the address with latitude and longitude, the price exactly as the site words it plus the number inside that wording, the sale method and the auction, tender or deadline date, bedrooms, bathrooms, land and floor area in square metres, title type, photos, open homes, and the listing agents with name, phone, mobile and email beside their agency's name, phone and website. listing adds the description, price changes, in-zone schools and, on request, the property record. property returns that record for any address: every recorded sale with price, date, method and days on market, council valuations over time, the site's estimated value range with its confidence, past listings with their asking prices and the last rental listing's weekly rent. sold lists recently sold homes in an area with sale price, capital value and estimate. locations, agent and agency complete it. No account, no browser - one ReefAPI key and the standard { ok, data, meta, error } envelope.
Most New Zealand homes for sale show no price - and a price filter still finds them
On realestate.co.nz a house for sale is usually sold by auction, tender, deadline or negotiation, with no number on the listing. The API returns price null for those - never 0 and never a guess - and tells you how each one is being sold. What we counted in the final live run on 2026-11-07:
| What the listing says | price returned | sale_method |
|---|---|---|
| $479,000 | 479000 | fixed_price |
| Asking Price $698,000 | 698000 | asking_price |
| Enquiries Over $540,000 | 540000 | enquiries_over |
| Auction | null (auction date returned) | auction |
| Deadline Sale | null (deadline date returned) | deadline_sale |
| Tender | null (tender date returned) | tender |
| Negotiation | null | negotiation |
| $620 per week (rental) | 620, price_period week | fixed_price |
Across the 21 searches of the final run, 221 of 384 rows carried a number in their price wording; the rest are auctions, tenders, deadline sales and negotiations. A price_min / price_max filter still returns those listings, because realestate.co.nz filters on a price the agent gives the site but does not display - so a $1.0M-$1.2M search can return an auction. price_display always keeps the site's own wording.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/realestate-nz/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"region": "Auckland",
"limit": 10
}
}{
"ok": true,
"meta": {
"api": "realestate-nz",
"endpoint": "search",
"mode": "live",
"latency_ms": 1092.5,
"record_count": 10,
"bytes": 246683,
"cache_hit": false,
"total": 17054,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "d8e5ec863aac48d3",
"fetched_at": "2026-11-06T22:29:45.608Z"
},
"data": {
"results": [
{
"listing_id": "43166837",
"url": "https://www.realestate.co.nz/43166837/residential/sale/145-symonds-street-eden-terrace",
"title": "Unrivalled Views & Parking to boot.",
"category": "residential_sale",
"category_code": "res_sale",
"property_type": "Apartment",
"status": "active",
"address": {
"full_address": "145 Symonds Street, Eden Terrace, Auckland City, Auckland",
"display_address": "145 Symonds Street, Eden Terrace",
"street_number": "145",
"street_number_suffix": null,
"unit_number": null,
"street": "Symonds Street",
"suburb": "Eden Terrace",
"district": "Auckland City",
"region": "Auckland",
"postcode": null,
"suburb_fq_slug": "auckland_auckland-city_eden-terrace_eden-terrace",
"latitude": -36.861972,
"longitude": 174.7612189,
"geo_accuracy": 10,
"address_published": true
},
"price_display": "$569,000",
"price": 569000,
"price_to": null,
"price_period": null,
"sale_method": "fixed_price",
"price_code": 1,
"currency": "NZD",
"auction": null,
"tender": null,
"deadline": null,
"bedrooms": 1,
"bathrooms": 1,
"ensuites": 0,
"toilets": 0,
"living_areas": 0,
"studies": 0,
"storeys": 0,
"parking": {
"garage": 0,
"covered": 0,
"other": 1
},
"land_area": null,
"land_area_unit": null,
"land_area_m2": null,
"floor_area": null,
"floor_area_unit": null,
"floor_area_m2": null,
"title_type": "Freehold",
"image": "https://mediaserver.realestate.co.nz/listings/43166837/b5d4ae4bfe15ffde7090e4c55a8aaae5.jpg",
"images": [
"https://mediaserver.realestate.co.nz/listings/43166837/b5d4ae4bfe15ffde7090e4c55a8aaae5.jpg",
"https://mediaserver.realestate.co.nz/listings/43166837/de7b44796e1e66b87d01b753849f3668.jpg",
"https://mediaserver.realestate.co.nz/listings/43166837/1120ca54b6e4984cd7598b2f40ddde22.jpg"
],
"image_count": 29,
"floorplans": null,
"videos": null,
"virtual_tours": null,
"open_homes": [],
"agents": [
{
"agent_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"first_name": "[trimmed-depth]",
"last_name": "[trimmed-depth]",
"phone": "[trimmed-depth]",
"mobile": "[trimmed-depth]",
"email": "[trimmed-depth]",
"image": "[trimmed-depth]",
"agency_name": "[trimmed-depth]",
"listing_count": "[trimmed-depth]",
"profile_url": "[trimmed-depth]"
}
],
"agency": {
"agency_id": "267139",
"name": "Apartment Specialists Group Ltd (Licensed: REAA 2008) - Auckland",
"trading_name": "Apartment Specialists - Auckland",
"phone": "[redacted-phone]",
"email": "[redacted-email]",
"website": "https://www.apartmentspecialists.co.nz/",
"logo": "https://mediaserver.realestate.co.nz/per_orgs/267139/00b98a474aa03a8e1ed3b71e70263741.jpg",
"brand_colour": "#9E131A",
"profile_url": "https://www.realestate.co.nz/office/267139/apartment-specialists-group-ltd-licensed-reaa-2008-auckland"
},
"listed_at": "2026-11-07T06:31:02+13:00",
"created_at": "2026-11-07T06:31:02+13:00",
"listing_reference": "6217119823",
"property_id": "xznyt9ckd",
"is_featured": true,
"is_new_construction": false,
"is_mortgagee_sale": false,
"is_coastal_waterfront": false,
"has_swimming_pool": false,
"is_private_listing": false,
"rates": null,
"rates_period": null
},
{
"listing_id": "43166838",
"url": "https://www.realestate.co.nz/43166838/residential/sale/10-flower-street-eden-terrace",
"title": "Two Bedrooms, One Very Handy Location",
"category": "residential_sale",
"category_code": "res_sale",
"property_type": "Apartment",
"status": "active",
"address": {
"full_address": "10 Flower Street, Eden Terrace, Auckland City, Auckland",
"display_address": "10 Flower Street, Eden Terrace",
"street_number": "10",
"street_number_suffix": null,
"unit_number": null,
"street": "Flower Street",
"suburb": "Eden Terrace",
"district": "Auckland City",
"region": "Auckland",
"postcode": null,
"suburb_fq_slug": "auckland_auckland-city_eden-terrace_eden-terrace",
"latitude": -36.866666,
"longitude": 174.7605049,
"geo_accuracy": 10,
"address_published": true
},
"price_display": "$479,000",
"price": 479000,
"price_to": null,
"price_period": null,
"sale_method": "fixed_price",
"price_code": 1,
"currency": "NZD",
"auction": null,
"tender": null,
"deadline": null,
"bedrooms": 2,
"bathrooms": 1,
"ensuites": 0,
"toilets": 0,
"living_areas": 0,
"studies": 0,
"storeys": 0,
"parking": {
"garage": 0,
"covered": 0,
"other": 1
},
"land_area": null,
"land_area_unit": null,
"land_area_m2": null,
"floor_area": 49,
"floor_area_unit": "sqm",
"floor_area_m2": 49,
"title_type": "Freehold",
"image": "https://mediaserver.realestate.co.nz/listings/43166838/dbc9a4324e87170779699ea17f6bda79.jpg",
"images": [
"https://mediaserver.realestate.co.nz/listings/43166838/dbc9a4324e87170779699ea17f6bda79.jpg",
"https://mediaserver.realestate.co.nz/listings/43166838/f0c8d94cbc80504e4df4b91a9c985fbf.jpg",
"https://mediaserver.realestate.co.nz/listings/43166838/9f81ba0008bc90b77c964b13edeaed54.jpg"
],
"image_count": 17,
"floorplans": null,
"videos": null,
"virtual_tours": null,
"open_homes": [],
"agents": [
{
"agent_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"first_name": "[trimmed-depth]",
"last_name": "[trimmed-depth]",
"phone": "[trimmed-depth]",
"mobile": "[trimmed-depth]",
"email": "[trimmed-depth]",
"image": "[trimmed-depth]",
"agency_name": "[trimmed-depth]",
"listing_count": "[trimmed-depth]",
"profile_url": "[trimmed-depth]"
}
],
"agency": {
"agency_id": "267139",
"name": "Apartment Specialists Group Ltd (Licensed: REAA 2008) - Auckland",
"trading_name": "Apartment Specialists - Auckland",
"phone": "[redacted-phone]",
"email": "[redacted-email]",
"website": "https://www.apartmentspecialists.co.nz/",
"logo": "https://mediaserver.realestate.co.nz/per_orgs/267139/00b98a474aa03a8e1ed3b71e70263741.jpg",
"brand_colour": "#9E131A",
"profile_url": "https://www.realestate.co.nz/office/267139/apartment-specialists-group-ltd-licensed-reaa-2008-auckland"
},
"listed_at": "2026-11-07T06:32:26+13:00",
"created_at": "2026-11-07T06:32:26+13:00",
"listing_reference": "6217120425",
"property_id": "7ych9s6dc",
"is_featured": true,
"is_new_construction": false,
"is_mortgagee_sale": false,
"is_coastal_waterfront": false,
"has_swimming_pool": false,
"is_private_listing": false,
"rates": null,
"rates_period": null
},
{
"listing_id": "43166839",
"url": "https://www.realestate.co.nz/43166839/residential/sale/15-nelson-street-auckland-central",
"title": "A Courtyard That Changes The Whole Apartment",
"category": "residential_sale",
"category_code": "res_sale",
"property_type": "Apartment",
"status": "active",
"address": {
"full_address": "15 Nelson Street, Auckland Central, Auckland City, Auckland",
"display_address": "15 Nelson Street, Auckland Central",
"street_number": "15",
"street_number_suffix": null,
"unit_number": null,
"street": "Nelson Street",
"suburb": "Auckland Central",
"district": "Auckland City",
"region": "Auckland",
"postcode": null,
"suburb_fq_slug": "auckland_auckland-city_auckland-central_auckland-central",
"latitude": -36.8468164,
"longitude": 174.7601318,
"geo_accuracy": 10,
"address_published": true
},
"price_display": "Negotiation",
"price": null,
"price_to": null,
"price_period": null,
"sale_method": "negotiation",
"price_code": 3,
"currency": "NZD",
"auction": null,
"tender": null,
"deadline": null,
"bedrooms": 1,
"bathrooms": 1,
"ensuites": 0,
"toilets": 0,
"living_areas": 0,
"studies": 0,
"storeys": 0,
"parking": {
"garage": 0,
"covered": 0,
"other": 1
},
"land_area": null,
"land_area_unit": null,
"land_area_m2": null,
"floor_area": null,
"floor_area_unit": null,
"floor_area_m2": null,
"title_type": "Freehold",
"image": "https://mediaserver.realestate.co.nz/listings/43166839/c698fd6309007af91c661691ea09a0ed.jpg",
"images": [
"https://mediaserver.realestate.co.nz/listings/43166839/c698fd6309007af91c661691ea09a0ed.jpg",
"https://mediaserver.realestate.co.nz/listings/43166839/057d99a78ac4d6d5b44a8012b8c1b104.jpg",
"https://mediaserver.realestate.co.nz/listings/43166839/62662ccf9fc332ab0f708331537a5020.jpg"
],
"image_count": 22,
"floorplans": null,
"videos": null,
"virtual_tours": null,
"open_homes": [],
"agents": [
{
"agent_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"first_name": "[trimmed-depth]",
"last_name": "[trimmed-depth]",
"phone": "[trimmed-depth]",
"mobile": "[trimmed-depth]",
"email": "[trimmed-depth]",
"image": "[trimmed-depth]",
"agency_name": "[trimmed-depth]",
"listing_count": "[trimmed-depth]",
"profile_url": "[trimmed-depth]"
}
],
"agency": {
"agency_id": "267139",
"name": "Apartment Specialists Group Ltd (Licensed: REAA 2008) - Auckland",
"trading_name": "Apartment Specialists - Auckland",
"phone": "[redacted-phone]",
"email": "[redacted-email]",
"website": "https://www.apartmentspecialists.co.nz/",
"logo": "https://mediaserver.realestate.co.nz/per_orgs/267139/00b98a474aa03a8e1ed3b71e70263741.jpg",
"brand_colour": "#9E131A",
"profile_url": "https://www.realestate.co.nz/office/267139/apartment-specialists-group-ltd-licensed-reaa-2008-auckland"
},
"listed_at": "2026-11-07T06:33:05+13:00",
"created_at": "2026-11-07T06:33:05+13:00",
"listing_reference": "6217120933",
"property_id": "d26v0n6wc",
"is_featured": true,
"is_new_construction": false,
"is_mortgagee_sale": false,
"is_coastal_waterfront": false,
"has_swimming_pool": false,
"is_private_listing": false,
"rates": null,
"rates_period": null
}
],
"count": 10,
"total_results": 17054,
"page": 1,
"limit": 10,
"has_more": true,
"property_type_counts": [
{
"property_type": "House",
"count": 9995
},
{
"property_type": "Townhouse",
"count": 2647
},
{
"property_type": "Apartment",
"count": 1420
}
],
"filters": {
"category": "residential_sale",
"category_code": "res_sale",
"locations": {
"region": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"fq_slug": "[trimmed-depth]"
}
]
},
"sort": "featured"
}
}
}What the realestate.co.nz API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search realestate.co.nz listings: homes for sale (default) or for rent, rural, commercial or business. Filter by region, district or suburb (names or ids), price, bedrooms, bathrooms, land and floor area, car parks, property type, sale method (auction, tender, deadline sale, negotiation, asking price …), keyword, open homes, new builds, pets and furnishing for rentals, agent or agency. Every row carries the listing URL, address and coordinates, the price exactly as shown plus the figure in it, sale method and auction/tender/deadline date, bedrooms, bathrooms, land and floor area, photos, open homes, and the listing agents (name, phone, mobile, email) with their agency. | Real-estate investors call search to search realestate.co.nz listings. | category, region, district, suburb, include_nearby_suburbs, ... |
| listing | One realestate.co.nz listing in full, live or ended (sold / withdrawn listings still resolve): everything a search row has plus the description, price change history, features, in-zone and nearby schools, early-childhood centres, links, and every agent's phone, mobile and email with the agency. include_property=true also attaches the property record (sales history, council valuation, estimate). | Brokerage tools call listing to get one realestate.co.nz listing in full, live or ended (sold / withdrawn listings still resolve). | listing_id, include_property, max_rotations |
| property | A property's record on realestate.co.nz (the address, whether or not it is listed now): every REINZ sale with price, date, method and days to sell; council valuations (capital, land and improvements value) over time; the site's estimated value range with its confidence and monthly history; past and current listings with the agent's listing price; the latest rental listing (weekly rent); bedrooms, bathrooms, land and floor area, building age; nearby recent sales. | Property dashboards call property to get a property's record on realestate.co.nz (the address, whether or not it is listed now). | property_id, max_rotations |
| sold | Recently sold properties in a region, district or suburb, from the REINZ sale records the site publishes: sale price, sale date, sale method, days to sell, plus each property's council valuation, the site's estimate, bedrooms, bathrooms, land and floor area. Filter by sale date, sale price, bedrooms, bathrooms, land and floor area; sort by sale date, sale price or estimate. | Lead-generation teams call sold to get recently sold properties in a region, district or suburb, from the REINZ sale records the sit…. | region, district, suburb, sold_after, sold_before, ... |
| locations | realestate.co.nz's own region → district → suburb list with ids: find a place by name (query), list a region's districts or a district's suburbs, or every region. Use the ids or names in search and sold. | Real-estate investors call locations to get realestate.co.nz's own region → district → suburb list with ids. | query, region, district, limit, max_rotations |
| agent | A real-estate agent's profile on realestate.co.nz: name, phone, mobile, email, photo, agency, licence class, how many listings they have now / recently / in total, by category and suburb, and the suburbs they work. Their listings: search with agent_id. | Brokerage tools call agent to get a real-estate agent's profile on realestate.co.nz. | agent_id, max_rotations |
| agency | A real-estate agency office on realestate.co.nz: name, trading name, phone, email, website, street and postal address, logo, listing counts by category, the suburbs it works, and every agent with phone, mobile and email. Its listings: search with agency_id. | Property dashboards call agency to get a real-estate agency office on realestate.co.nz. | agency_id, max_rotations |
Call search from your stack
curl -X POST https://api.reefapi.com/realestate-nz/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"region":"Auckland","limit":10}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/realestate-nz/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"region": "Auckland",
"limit": 10
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/realestate-nz/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"region": "Auckland",
"limit": 10
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.realestate-nz.search with {"region":"Auckland","limit":10}.Who uses this API and why
- Rent-versus-buy and affordability calculators pull current asking prices and weekly rents for a suburb, then the sold prices, council valuations and estimates for the same area.
- Buyer and renter alert apps watch a list of suburbs for new listings with bedrooms, bathrooms, price and open-home times, and link straight to the realestate.co.nz listing.
- Agency and proptech CRMs map which agents and offices list where, with their phone and email, and track each agent's listing counts.
- Property analysts compare asking prices, sale methods and days on market across New Zealand districts.
Questions developers ask before integrating
Does it return the agent's phone number and email?
Yes, as the site publishes them. Every listing carries its agents with name, office phone, mobile and email, plus the agency's name, phone, email and website. In the final live run all 340 rows that named an agent had the agent's name, mobile and email (36 more were agency-only rentals, 8 were private owner listings). realestate.co.nz sends these contact details in the data behind each listing page; the page itself offers an enquiry form rather than printing the email. Some rentals managed by a property-management office list no individual agent - those rows return agents as an empty list and the agency's contacts.
How do I pick a suburb that exists in more than one place?
Pass the region or district too, or the id. Hillcrest, for example, is a suburb in Auckland's North Shore, in Rotorua and in Hamilton - a bare "Hillcrest" returns an error that lists all three with their ids, and suburb Hillcrest with district Hamilton City searches the Hamilton one. Names are matched without case or accents; district names work with or without "City" (Christchurch = Christchurch City). The locations action lists every region, district and suburb with its id.
If I give a region and a suburb, which one is searched?
The suburb. realestate.co.nz combines location filters as "either", so Auckland plus Ponsonby would otherwise return all of Auckland. The API drops a region or district that already contains a suburb you named, and keeps unrelated ones - Rodney plus Ponsonby searches both.
Can I get sold prices and what a home is worth?
Yes. sold lists homes sold in a region, district or suburb with the sale price, sale date, how it sold and days on market, from the sale records realestate.co.nz publishes, plus each home's council capital value and the site's estimated value range. property returns one home's full record: every recorded sale, council valuations over time, the estimate with its monthly history and confidence (1 to 5), past listings with their asking prices and the last rental listing's weekly rent - the inputs a rent-versus-buy comparison needs. In the final run all 104 sold rows had a sale price and a council capital value, and 97 had an estimate.
How reliable is the site's estimate?
It comes with the site's own confidence rating from 1 to 5, returned beside it - use it. A confidence-1 estimate can be far off: we saw a mid estimate of NZ$93,000 on an apartment listed at NZ$479,000. Confidence-5 estimates sat close to recent sale prices.
Are land areas in square metres?
Agents enter land area in square metres or hectares; land_area and land_area_unit return it as entered and land_area_m2 converts hectares (1 ha = 10,000 m²). The land area filter is in square metres.
What does realestate.co.nz not publish?
No price on auction, tender, deadline and negotiation listings (see above). No sale price on the listing itself - the sale appears on the property record once the sale is recorded. Most businesses for sale hide their street address (address_published false; district and region are kept). Some rentals name no individual agent. Council valuation is missing on some apartments. Open homes that have passed stay on some listings - they come back flagged is_past.
What is the realestate.co.nz API?
realestate.co.nz API is a ReefAPI endpoint group for new zealand homes for sale and rent with agents, plus sold prices, council valuations and estimates, in nzd. It returns live JSON through POST requests under /realestate-nz/v1.
Is the realestate.co.nz API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. realestate.co.nz calls use the same shared credit balance as every other ReefAPI engine.
Do I need a realestate.co.nz login or account?
No login to realestate.co.nz is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the realestate.co.nz data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the realestate.co.nz API use?
realestate.co.nz actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call realestate.co.nz from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call realestate-nz actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the realestate.co.nz API a realestate.co.nz scraper?
It is the managed alternative to a DIY realestate.co.nz scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same new zealand homes for sale and rent with agents, plus sold prices, council valuations and estimates, in nzd back as clean JSON.