New Zealand property listings with their agents - and what homes actually sold for
The realestate.co.nz API returns New Zealand's industry-run property portal as clean JSON, in NZD.
- endpoints
- 7
- credits per call
- 1–2
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
- Unrivalled Views & Parking to boot.$569,000
- category
- residential_sale
- property_type
- Apartment
- Two Bedrooms, One Very Handy Location$479,000
- category
- residential_sale
- property_type
- Apartment
- A Courtyard That Changes The Whole ApartmentNegotiation
- category
- residential_sale
- property_type
- Apartment
7 active endpoints, on 1 and 2 credit tiers.
- POST/realestate-nz/v1/search2 credits
- POST/realestate-nz/v1/listing2 credits
- POST/realestate-nz/v1/property2 credits
- POST/realestate-nz/v1/sold2 credits
- POST/realestate-nz/v1/locations1 credit
- POST/realestate-nz/v1/agent1 credit
- POST/realestate-nz/v1/agency2 credits
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
realestate.co.nz API
3 of 7 endpoints, ready to run
Up to 100 listings for sale or rent: realestate.co.nz URL, address and coordinates, the price as worded and the number in it, sale method and auction date, bedrooms, bathrooms, land and floor area, photos, open homes, agents with phone and email, agency.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What realestate.co.nz endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a realestate.co.nz endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the realestate.co.nz API works
realestate.co.nz is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 632 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Rent or buy in one suburb: asking prices, weekly rents and what homes sold for
Three calls give a calculator the three numbers it needs for a suburb - what sellers ask, what tenants pay and what buyers actually paid.
{"suburb": "Ponsonby", "region": "Auckland", "bedrooms_min": 3}Current listings for sale with the price as worded, the number inside it where there is one, and the agents to contact.
{"category": "residential_rent", "suburb": "Ponsonby", "region": "Auckland", "bedrooms_min": 3}The same suburb's rentals, every price per week, with available date, pets and bond.
{"suburb": "Ponsonby", "region": "Auckland", "sold_after": "2026-01-01"}What homes there sold for this year, with council capital value and the site's estimate beside each sale.
Asking prices, weekly rents and sale prices for one suburb from one source, each row linking back to realestate.co.nz.
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}'{
"ok": true,
"data": { … },
"meta": {
"api": "realestate-nz",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
What realestate.co.nz publishes, what it does not, and how it was checked
realestate.co.nz only - New Zealand, prices in NZD. Measured on 2026-11-07 in the final live run; some of these lines go against us.
search covers residential sale (the default) and rent, rural sale, commercial sale and lease, and businesses for sale, each with its own property types. Every region, district and suburb on the site can be searched, by name or id, singly or several at once.
url is the listing's own page on realestate.co.nz on every row; agents and agencies carry their profile URLs too.
Of 384 search rows in the final run, 340 named an agent and all 340 had the agent's name, mobile and email (108 also an office phone); 36 rentals run by a property-management office named no individual agent and came back with the agency's details; 8 were private owner listings.
Auctions, tenders, deadline sales and negotiations carry no number. price is null for them, the sale method and the auction, tender or deadline date are returned instead, and price_display keeps the site's wording. A price filter still finds them, because the site filters on a price it does not show.
sold and property return recorded sales (price, date, method, days on market), council capital, land and improvement values over time, and the site's estimate range with a confidence rating from 1 to 5. A low-confidence estimate can be far off and is returned with its rating.
Most businesses for sale hide their street address. Some apartments have no council valuation. Coordinates were on 296 of 384 search rows (businesses and agent-hidden addresses have none). Land area is in square metres or hectares as entered; land_area_m2 converts.
Final live run: 21 searches, 14 listings, 5 property records, 5 sold searches, 5 location look-ups, 4 agents and 3 agencies - 57 of 57 succeeded, and 11 of 11 wrong inputs failed with a clear error. Median time: search 1.1 s, listing 0.8 s, property 0.6 s, sold 1.5 s, agent 0.6 s; agency 4.3 s (it looks up every agent of the office). On 12 listings the search row and the full listing agreed on URL, price, sale method, bedrooms, bathrooms, areas, property type, photo, address and agents: 0 differences.
What people build with realestate.co.nz
The jobs this data is most often used for.
endpoints
credits per call
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.
What realestate.co.nz data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 632 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"])Have a question? We got answers.
The questions people actually ask before wiring up realestate.co.nz.
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.
29 Real Estate APIs on the same key
One key, one credit pool, one response envelope. If you are pulling realestate.co.nz, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 631 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-07.