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.

ParameterTypeRequiredAllowed values
typestringRequiredsale, sold, off_market, rent
qstringOptionalUp to 100 characters
bboxstringOptionalAny
polylinestringOptionalUp to 20,000 characters
bedrooms_minintegerOptionalAny
bedrooms_maxintegerOptionalAny
bathrooms_minintegerOptionalAny
bathrooms_maxintegerOptionalAny
price_minnumberOptionalAny
price_maxnumberOptionalAny
date_minstringOptionalAny
date_maxstringOptionalAny
sortstringOptionaldate
pageintegerOptionalAny
per_pageintegerOptionalAny

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.