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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.