APIs / homes.co.nz / Search
homes.co.nz: Search
Search from homes.co.nz as JSON. 1 credit per successful call.
GET /v1/homes-co-nz/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
type | string | Required | sale, sold, off_market, rent |
q | string | Optional | Up to 100 characters |
bbox | string | Optional | Any |
polyline | string | Optional | Up to 20,000 characters |
bedrooms_min | integer | Optional | Any |
bedrooms_max | integer | Optional | Any |
bathrooms_min | integer | Optional | Any |
bathrooms_max | integer | Optional | Any |
price_min | number | Optional | Any |
price_max | number | Optional | Any |
date_min | string | Optional | Any |
date_max | string | Optional | Any |
sort | string | Optional | date |
page | integer | Optional | Any |
per_page | integer | Optional | Any |
Example request
homes.co.nz
GET/v1/homes-co-nz/search?type=sale&q=ponsonby&bedrooms_min=3
{
"success": true,
"data": {
"items": [
{
"id": "c260d365-cdc8-422e-b6c3-a925a0579ef3",
"listing_id": "c260d365-cdc8-422e-b6c3-a925a0579ef3",
"property_id": "18886331-d922-4e17-b3be-269b4469f9f2",
"listing_type": "sale",
"url": "https://homes.co.nz/auckland/ponsonby/10-ardmore-road/axPjy",
"display_price": "Auction on 10 Dec, 2:00 pm",
"price_known": false,
"currency": "NZD",
"date": "2026-11-10T21:38:59.663Z",
"featured_at": "2026-11-10T21:38:59.663Z",
"headline": "Villa Extraordinaire...",
"address": {
"full": "10 Ardmore Road, Ponsonby, Auckland City, Auckland",
"street_number": "10",
"street": "Ardmore Road",
"suburb": "Ponsonby",
"city": "Auckland"
},
"coordinates": {
"latitude": -36.846161,
"longitude": 174.736984
},
"bedrooms": 3,
"bathrooms": 2,
"car_spaces": 4,
"floor_area_sqm": 180,
"land_area_sqm": 629,
"decade_built": "1900",
"ownership_type": "Freehold",
"legal_description": "LOT 5 BLK 2 DP 2954 629M2",
"images": [
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/10861451901877332713",
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/17082992377575497044",
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/158204980527899720"
],
"estimate": {
"value_text": "3.38M",
"low_text": "3.18M",
"high_text": "3.58M",
"as_of": "2026-11-12"
},
"rental_estimate": {
"low_text": "1,240",
"high_text": "1,490",
"yield": "2.1%",
"as_of": "2026-05-02"
},
"values": {
"capital_value": 3500000,
"land_value": 3025000,
"improvement_value": 475000,
"as_of": "2024-05-01"
},
"agents": [
{
"id": "1b3168bc-12b8-414e-9386-ec5bacd1f712",
"name": "Jason Trowbridge",
"photo": "https://trademe.tmcdn.co.nz/tm/property/agent_individual_profile/agent_individual_profile1312835v8.jpg",
"mobile_phone": "021 358 888",
"is_team": false,
"agency_id": "dc8cab55-5c32-44ba-8997-65e01b13b408",
"url": "https://homes.co.nz/agent/1b3168bc-12b8-414e-9386-ec5bacd1f712"
}
],
"agency": {
"id": "dc8cab55-5c32-44ba-8997-65e01b13b408",
"name": "Ponsonby",
"brand": "Ray White",
"logo": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/8914244-2.jpg",
"phone": "+64-9-7777812",
"url": "https://homes.co.nz/branch/dc8cab55-5c32-44ba-8997-65e01b13b408"
},
"suburb_id": 1279,
"city_id": 100004
},
{
"id": "6c1a0dee-0388-4e3d-86e9-a5c3c26e3e15",
"listing_id": "6c1a0dee-0388-4e3d-86e9-a5c3c26e3e15",
"property_id": "ad8cc020-aea4-4165-bf20-72e015591e9e",
"listing_type": "sale",
"url": "https://homes.co.nz/auckland/ponsonby/8-lincoln-street/K7VAB",
"display_price": "Auction on 17 Dec, 2:00 pm",
"price_known": false,
"currency": "NZD",
"date": "2026-11-10T21:37:22.543Z",
"featured_at": "2026-11-10T21:37:22.543Z",
"headline": "Ponsonby Charmer...",
"address": {
"full": "8 Lincoln Street, Ponsonby, Auckland City, Auckland",
"street_number": "8",
"street": "Lincoln Street",
"suburb": "Ponsonby",
"city": "Auckland"
},
"coordinates": {
"latitude": -36.854454,
"longitude": 174.744675
},
"bedrooms": 6,
"bathrooms": 2,
"floor_area_sqm": 246,
"land_area_sqm": 369,
"decade_built": "1900",
"ownership_type": "Freehold",
"legal_description": "PT LOT 39 ALLOT 31 SEC 8 SUBURBS AUCKLAND 369M2, PT LOT 41 ALLOT 31 SEC 8 SU",
"images": [
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/10521112919790155441",
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/11358924665838627491",
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/1019161069077745273"
],
"estimate": {
"value_text": "2.57M",
"low_text": "2.42M",
"high_text": "2.73M",
"as_of": "2026-11-12"
},
"values": {
"capital_value": 2525000,
"land_value": 1975000,
"improvement_value": 550000,
"as_of": "2024-05-01"
},
"agents": [
{
"id": "1b3168bc-12b8-414e-9386-ec5bacd1f712",
"name": "Jason Trowbridge",
"photo": "https://trademe.tmcdn.co.nz/tm/property/agent_individual_profile/agent_individual_profile1312835v8.jpg",
"mobile_phone": "021 358 888",
"is_team": false,
"agency_id": "dc8cab55-5c32-44ba-8997-65e01b13b408",
"url": "https://homes.co.nz/agent/1b3168bc-12b8-414e-9386-ec5bacd1f712"
}
],
"agency": {
"id": "dc8cab55-5c32-44ba-8997-65e01b13b408",
"name": "Ponsonby",
"brand": "Ray White",
"logo": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/8914244-2.jpg",
"phone": "+64-9-7777812",
"url": "https://homes.co.nz/branch/dc8cab55-5c32-44ba-8997-65e01b13b408"
},
"suburb_id": 1279,
"city_id": 100004
},
{
"id": "f31a79f1-d3b4-4235-b480-fd9e9bf7d329",
"listing_id": "f31a79f1-d3b4-4235-b480-fd9e9bf7d329",
"property_id": "7bcec25c-a428-4557-b801-f0eacef8c0a2",
"listing_type": "sale",
"url": "https://homes.co.nz/auckland/ponsonby/37-wanganui-avenue/4j5L",
"display_price": "Auction on 2 Dec, 2:00 pm",
"price_known": false,
"currency": "NZD",
"date": "2026-11-10T01:16:35.817Z",
"featured_at": "2026-11-10T01:16:35.817Z",
"headline": "Classic character, bright future",
"address": {
"full": "37 Wanganui Avenue, Ponsonby, Auckland City, Auckland",
"street_number": "37",
"street": "Wanganui Avenue",
"suburb": "Ponsonby",
"city": "Auckland"
},
"coordinates": {
"latitude": -36.848248,
"longitude": 174.735962
},
"bedrooms": 4,
"bathrooms": 1,
"car_spaces": 1,
"floor_area_sqm": 136,
"land_area_sqm": 416,
"decade_built": "1910",
"ownership_type": "Freehold",
"legal_description": "LOT 34 BLK 2 DP 3365 416M2",
"images": [
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/7056014092565100514",
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/3227105438580156454",
"https://s3-ap-southeast-2.amazonaws.com/homes-listing-images/13509313857570272951"
],
"estimate": {
"value_text": "2.77M",
"low_text": "2.61M",
"high_text": "2.94M",
"as_of": "2026-11-12"
},
"rental_estimate": {
"low_text": "1,260",
"high_text": "1,500",
"yield": "2.6%",
"as_of": "2026-11-02"
},
"values": {
"capital_value": 3050000,
"land_value": 2725000,
"improvement_value": 325000,
"as_of": "2024-05-01"
},
"agents": [
{
"id": "cf576c91-ddd3-4125-ac11-9675993fcbf9",
"name": "Luke McCaw",
"photo": "https://trademe.tmcdn.co.nz/property/agent_profile/160x160/agent_individual_profile6277794v4.jpg",
"office_phone": "021 950145",
"mobile_phone": "09 3756882",
"is_team": false,
"agency_id": "5861fe7e-bbf8-4289-ba5d-cbda27145262",
"url": "https://homes.co.nz/agent/cf576c91-ddd3-4125-ac11-9675993fcbf9"
}
],
"agency": {
"id": "5861fe7e-bbf8-4289-ba5d-cbda27145262",
"name": "Ponsonby",
"brand": "Bayleys",
"logo": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/4938899-11.jpg",
"phone": "+64-9-3758494",
"url": "https://homes.co.nz/branch/5861fe7e-bbf8-4289-ba5d-cbda27145262"
},
"suburb_id": 1279,
"city_id": 100004
}
],
"excluded_by_filters": 0,
"search_area": {
"source": "suburb_boundary",
"name": "Ponsonby, Auckland"
},
"pagination": {
"page": 1,
"per_page": 20,
"total": 30,
"has_more": true
}
},
"meta": {
"endpoint_family": "search",
"request_id": "req_b6fce82dda4f4349b6bd280c31005621",
"credits_charged": 1,
"credits_remaining": 1863
}
}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.