--- title: "realestate.co.nz API: Search | Perceptlayer" description: "Search from realestate.co.nz as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/realestate-co-nz/search --- [APIs](https://perceptlayer.com/apis) / [realestate.co.nz](https://perceptlayer.com/apis/realestate-co-nz) / Search # realestate.co.nz: Search Search from realestate.co.nz as JSON. 1 credit per successful call. GET `/v1/realestate-co-nz/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `type` | string | Required | sale, rent | | `page` | integer | Optional | Any | | `rows` | integer | Optional | Any | | `region` | string | Optional | Any | | `district` | string | Optional | Any | | `suburb` | string | Optional | Any | | `agent` | string | Optional | Any | | `office` | string | Optional | Any | | `school` | string | Optional | Any | | `price_min` | integer | Optional | Any | | `price_max` | integer | Optional | Any | | `bedrooms_min` | integer | Optional | Any | | `bedrooms_max` | integer | Optional | Any | | `bathrooms_min` | integer | Optional | Any | | `bathrooms_max` | integer | Optional | Any | | `carparks` | integer | Optional | Any | | `land_area_min` | integer | Optional | Any | | `land_area_max` | integer | Optional | Any | | `floor_area_min` | integer | Optional | Any | | `floor_area_max` | integer | Optional | Any | | `property_type` | string | Optional | Any | | `keyword` | string | Optional | Up to 100 characters | | `sort` | string | Optional | best-match, featured, latest, oldest, lowest-price, highest-price, lowest-land-area, highest-land-area | | `open_home` | boolean | Optional | Any | | `new_construction` | boolean | Optional | Any | | `mortgagee_sale` | boolean | Optional | Any | | `swimming_pool` | boolean | Optional | Any | | `pets_allowed` | boolean | Optional | Any | | `floor_plans` | boolean | Optional | Any | | `videos` | boolean | Optional | Any | | `coastal_waterfront` | boolean | Optional | Any | | `include_nearby_suburbs` | boolean | Optional | Any | ## Example request realestate.co.nz GET /v1/realestate-co-nz/search?type=sale&rows=2®ion=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 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/realestate-co-nz?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.