Sign inGet a free API keyDashboard
Menu

APIs / Real estate / realestate.co.nz

1 credit per call7 endpoints30 datapoints

realestate.co.nz API

realestate.co.nz API for New Zealand homes for sale or rent, listings, agents, offices, facets and location lookup as JSON. 1 credit per successful call.

Get a free API keyRun it below
realestate.co.nz
GET/v1/realestate-co-nz/search?type=sale&rows=2&region=35&bedrooms_min=3&sort=latest
{
  "success": true,
  "data": {
    "total_count": 12353,
    "page": 1,
    "page_size": 2,
    "has_more": true,
    "max_results_per_query": 10000,
    "search_location": {
      "regions": [
        "Auckland"
      ]
    },
    "listings": [
      {
        "id": 43171224,
        "listing_no": "944422",
        "url": "https://www.realestate.co.nz/43171224/residential/sale/50-baverstock-road-flat-bush",
        "title": "MORTGAGEE SALE",
        "status": "active",
        "category": "res_sale",
        "property_type": "House",
        "price_text": "Auction",
        "currency": "NZD",
        "price_code": 5,
        "auction_at": "2026-12-09T01:00:00Z",
        "auction_location": "18 Commerce St, Auckland City (Branch Office)",
        "address": {
          "full": "50 Baverstock Road, Flat Bush, Manukau City, Auckland",
          "display": "50 Baverstock Road, Flat Bush",
          "street_number": "50",
          "street": "Baverstock Road",
          "suburb": "Flat Bush",
          "district": "Manukau City",
          "region": "Auckland",
          "suburb_slug": "auckland_manukau-city_flat-bush_flat-bush",
          "district_slug": "auckland_manukau-city",
          "region_slug": "auckland",
          "latitude": -36.955940246582,
          "longitude": 174.91738891602
        },
        "bedrooms": 5,
        "bathrooms": 3,
        "land_area": 400,
        "land_area_unit": "sqm",
        "land_area_sqm": 400,
        "published_at": "2026-11-12T13:31:06Z",
        "created_at": "2026-11-12T13:31:02Z",
        "is_new_construction": false,
        "is_mortgagee_sale": true,
        "is_coastal_waterfront": false,
        "has_swimming_pool": false,
        "is_featured": false,
        "description": "MORTGAGEE AUCTION– 50 Baverstock Road, Flat Bush\n248m² of Family Living, One Great Location!\n\nNeed more room for the family? This five-bedroom home has approximately 248m² of floor area (according to Property Smarts) over two levels, on a 4…",
        "photo_count": 7,
        "photos": [
          {
            "url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.jpg",
            "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.crop.31x40.jpg",
            "medium_url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.crop.105x134.jpg",
            "large_url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.crop.140x178.jpg"
          },
          {
            "url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.jpg",
            "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.crop.31x40.jpg",
            "medium_url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.crop.105x134.jpg",
            "large_url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.crop.140x178.jpg"
          },
          {
            "url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.jpg",
            "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.crop.31x40.jpg",
            "medium_url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.crop.105x134.jpg",
            "large_url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.crop.140x178.jpg"
          }
        ],
        "agents": [
          {
            "id": 459473,
            "name": "Ari Tidyman",
            "first_name": "Ari",
            "last_name": "Tidyman",
            "slug": "ari-tidyman",
            "phone": "021 026 46621",
            "email": "a.tidyman@barfoot.co.nz",
            "website_url": "https://www.barfoot.co.nz/a.tidyman",
            "image": "…",
            "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - City Office",
            "listing_count": 24
          },
          {
            "id": 467732,
            "name": "Kristina Clarke",
            "first_name": "Kristina",
            "last_name": "Clarke",
            "slug": "kristina-clarke",
            "phone": "021 082 79272",
            "email": "k.clarke@barfoot.co.nz",
            "website_url": "https://www.barfoot.co.nz/k.clarke",
            "image": "…",
            "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - City Office",
            "listing_count": 11
          }
        ],
        "office": {
          "id": 12647,
          "name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - City Office",
          "colloquial_name": "Barfoot & Thompson - City Office",
          "slug": "barfoot-thompson-ltd-licensed-reaa-2008-city-office",
          "phone": "09 307 6340",
          "email": "city@barfoot.co.nz",
          "logo_url": "https://mediaserver.realestate.co.nz/per_orgs/12647/28e841442d16d0273c207665f5a81896.jpg",
          "brand_colour": "#003572"
        }
      },
      {
        "id": 43171223,
        "listing_no": "944072",
        "url": "https://www.realestate.co.nz/43171223/residential/sale/6-ridgeview-close-red-beach",
        "title": "The Ultimate Red Beach All-Rounder ",
        "status": "active",
        "category": "res_sale",
        "property_type": "House",
        "price_text": "Auction",
        "currency": "NZD",
        "price_code": 5,
        "auction_at": "2026-12-01T20:30:00Z",
        "auction_location": "8-12 The Promenade, Takapuna",
        "address": {
          "full": "6 Ridgeview Close, Red Beach, Rodney, Auckland",
          "display": "6 Ridgeview Close, Red Beach",
          "street_number": "6",
          "street": "Ridgeview Close",
          "suburb": "Red Beach",
          "district": "Rodney",
          "region": "Auckland",
          "suburb_slug": "auckland_rodney_red-beach_red-beach",
          "district_slug": "auckland_rodney",
          "region_slug": "auckland",
          "latitude": -36.606060028076,
          "longitude": 174.68858337402
        },
        "bedrooms": 4,
        "bathrooms": 2,
        "parking": {
          "garage": 2,
          "carport": 0,
          "off_street": 3
        },
        "land_area": 635,
        "land_area_unit": "sqm",
        "land_area_sqm": 635,
        "published_at": "2026-11-12T13:30:43Z",
        "created_at": "2026-11-12T13:30:39Z",
        "is_new_construction": false,
        "is_mortgagee_sale": false,
        "is_coastal_waterfront": false,
        "has_swimming_pool": false,
        "is_featured": false,
        "description": "Auction: 8-12 The Promenade, Takapuna on Wednesday 2 December 2026 at 9:30AM  (unless sold prior)\n\n Positioned in one of Red Beach’s most sought-after pockets, 6 Ridgeview Close truly ticks every single box. Effortlessly blending low-mainte…",
        "photo_count": 31,
        "photos": [
          {
            "url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.jpg",
            "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.crop.31x40.jpg",
            "medium_url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.crop.105x134.jpg",
            "large_url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.crop.140x178.jpg"
          },
          {
            "url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.jpg",
            "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.crop.31x40.jpg",
            "medium_url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.crop.105x134.jpg",
            "large_url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.crop.140x178.jpg"
          },
          {
            "url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.jpg",
            "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.crop.31x40.jpg",
            "medium_url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.crop.105x134.jpg",
            "large_url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.crop.140x178.jpg"
          }
        ],
        "agents": [
          {
            "id": 563543,
            "name": "Drue Matich",
            "first_name": "Drue",
            "last_name": "Matich",
            "slug": "drue-matich",
            "phone": "021 024 90448",
            "email": "d.matich@barfoot.co.nz",
            "website_url": "https://www.barfoot.co.nz/d.matich",
            "image": "…",
            "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - Whangaparaoa",
            "listing_count": 29
          },
          {
            "id": 886645,
            "name": "Danielle Bedford",
            "first_name": "Danielle",
            "last_name": "Bedford",
            "slug": "danielle-bedford",
            "phone": "021 263 8221",
            "email": "d.bedford@barfoot.co.nz",
            "website_url": "https://www.barfoot.co.nz/d.bedford",
            "image": "…",
            "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - Whangaparaoa",
            "listing_count": 15
          }
        ],
        "office": {
          "id": 14882,
          "name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - Whangaparaoa",
          "colloquial_name": "Barfoot & Thompson - Whangaparaoa",
          "slug": "barfoot-thompson-ltd-licensed-reaa-2008-whangaparaoa",
          "phone": "09 424 9199",
          "email": "whanga@barfoot.co.nz",
          "logo_url": "https://mediaserver.realestate.co.nz/per_orgs/14882/28e841442d16d0273c207665f5a81896.jpg",
          "brand_colour": "#003572"
        }
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_efa646d48f1e4a1e9fe817107ac9d85e",
    "credits_charged": 1,
    "credits_remaining": 1819
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 2 items.

#idintegerlisting_nostringurlurltitlestringstatusstringcategorystringproperty_typestringprice_textstringcurrencystringprice_codeintegerauction_atstringauction_locationstringaddressobjectbedroomsintegerbathroomsintegerland_areaintegerland_area_unitstringland_area_sqmintegerpublished_atstringcreated_atstringis_new_constructionbooleanis_mortgagee_salebooleanis_coastal_waterfrontbooleanhas_swimming_poolbooleanis_featuredbooleandescriptionstringphoto_countintegerphotosobject[]agentsobject[]officeobject
143171224944422https://www.realestate.co.nz/43171224/residential/sale/50-baverstock-road-flat-bushMORTGAGEE SALEactiveres_saleHouseAuctionNZD52026-12-09T01:00:00Z18 Commerce St, Auckland City (Branch Office){12 fields}53400sqm4002026-11-12T13:31:06Z2026-11-12T13:31:02ZfalsetruefalsefalsefalseMORTGAGEE AUCTION– 50 Baverstock Road, Flat Bush 248m² of Family Living, One Great Location! Need more room for the family? This five-bedroom home has approximately 248m² of floor area (according to Property Smarts) over two levels, on a 4…7[3 items][2 items]{8 fields}
243171223944072https://www.realestate.co.nz/43171223/residential/sale/6-ridgeview-close-red-beachThe Ultimate Red Beach All-Rounder activeres_saleHouseAuctionNZD52026-12-01T20:30:00Z8-12 The Promenade, Takapuna{12 fields}42635sqm6352026-11-12T13:30:43Z2026-11-12T13:30:39ZfalsefalsefalsefalsefalseAuction: 8-12 The Promenade, Takapuna on Wednesday 2 December 2026 at 9:30AM (unless sold prior) Positioned in one of Red Beach’s most sought-after pockets, 6 Ridgeview Close truly ticks every single box. Effortlessly blending low-mainte…31[3 items][2 items]{8 fields}

Recorded from our API · 2 items shown · 30 datapoints per itemGET /v1/realestate-co-nz/search?type=sale&rows=2&region=35&bedrooms_min=3&sort=latest

30 datapoints

Identity

  • idinteger
  • titlestring
  • statusstring
  • categorystring
  • property_typestring

Contact

  • urlurl
  • agentsobject[]

Location

  • auction_locationstring
  • addressobject
  • land_areainteger
  • land_area_unitstring
  • land_area_sqminteger

Reputation

  • photo_countinteger
  • photosobject[]

Price

  • price_textstring
  • currencystring
  • price_codeinteger

Other

  • listing_nostring
  • auction_atstring
  • bedroomsinteger
  • bathroomsinteger
  • published_atstring
  • created_atstring
  • is_new_constructionboolean
  • is_mortgagee_saleboolean
  • is_coastal_waterfrontboolean
  • has_swimming_poolboolean
  • is_featuredboolean
  • descriptionstring
  • officeobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/realestate-co-nz/search?type=sale&rows=2&region=35&bedrooms_min=3&sort=latest" \
  -H "X-API-Key: $API_KEY"

realestate.co.nz · 7 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/realestate-co-nz/agent
id+4 optional
1 credit
GET/v1/realestate-co-nz/autocomplete
q+1 optional
1 credit
GET/v1/realestate-co-nz/facets
type+3 optional
1 credit
GET/v1/realestate-co-nz/listing
id
1 credit
GET/v1/realestate-co-nz/locations
none
1 credit
GET/v1/realestate-co-nz/office
id
1 credit
GET/v1/realestate-co-nz/search
type+31 optional
1 credit

Overview

What you can get

The realestate.co.nz API returns realestate.co.nz property data as JSON through 7 endpoints.

  • Search: search takes a type (sale or rent), with page, rows, region, district, suburb, agent, office, school, price_min, price_max, bedrooms_min, bedrooms_max, bathrooms_min, bathrooms_max, carparks, land_area_min, land_area_max, floor_area_min, floor_area_max, property_type, keyword, sort (best-match, featured, latest, oldest, lowest-price, highest-price, lowest-land-area or highest-land-area), and the true-or-false filters open_home, new_construction, mortgagee_sale, swimming_pool, pets_allowed, floor_plans, videos, coastal_waterfront and include_nearby_suburbs. facets takes a type, with region, district and suburb.
  • Listings: listing takes an id.
  • Agents and offices: agent takes an id, with include_listings, type (sale or rent), page and rows; office takes an id.
  • Locations: autocomplete takes a q, with type; locations takes no parameters.

The recorded search for homes for sale in region 35 (Auckland) with at least three bedrooms, sorted by latest with 2 rows, returns listings with id, listing_no, url, title, status, category, property_type, price_text, currency, auction_at, auction_location, address, bedrooms, bathrooms, land_area, land_area_sqm, published_at, is_new_construction, is_mortgagee_sale, is_coastal_waterfront, has_swimming_pool, is_featured, description, photo_count, photos, agents and office. It also returns total_count (12,353), page_size, has_more and max_results_per_query.

How a call works

Search a region: GET /v1/realestate-co-nz/search?type=sale&region=35&bedrooms_min=3&sort=latest&rows=2 with your key in the X-API-Key header. Each listing's id is what listing takes; each of its agents carries the id that agent takes, and its office.id is what office takes. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track new listings for sale or rent in Auckland or another New Zealand region

Use the realestate.co.nz API to track new listings for sale or rent in Auckland or another New Zealand region

Watch mortgagee sales with `mortgagee_sale=true`

Use the realestate.co.nz API to watch mortgagee sales with `mortgagee_sale=true`

Plan auctions from `auction_at` and `auction_location`

Use the realestate.co.nz API to plan auctions from `auction_at` and `auction_location`

Search homes near a school with `school`

Use the realestate.co.nz API to search homes near a school with `school`

FAQ

Questions

Do I need a realestate.co.nz account?

No. You call this realestate.co.nz API with your Perceptlayer key in the `X-API-Key` header, with no realestate.co.nz login.

How much does the realestate.co.nz API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

How many results can one search return?

The recorded Auckland search reports a `total_count` of 12,353 and a `max_results_per_query` of 10,000. Narrow by district, suburb, price or bedrooms to reach the rest.

Should I build a realestate.co.nz scraper instead?

You can, but a realestate.co.nz scraper is code you maintain: page changes break it, requests get blocked, and realestate.co.nz's terms govern how you collect data. The realestate.co.nz API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the realestate.co.nz API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs