Sign inGet a free API keyDashboard
Menu

APIs / Real estate / homes.co.nz

1 credit per call6 endpoints29 datapoints

homes.co.nz API

homes.co.nz API for New Zealand property search, listings, property records with estimates, agents and agencies as JSON. 1 credit per successful call.

Get a free API keyRun it below
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.

Sample data

What one call returns

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

#idstringlisting_idstringproperty_idstringlisting_typestringurlurldisplay_pricestringprice_knownbooleancurrencystringdatestringfeatured_atstringheadlinestringaddressobjectcoordinatesobjectbedroomsintegerbathroomsintegercar_spacesnumberfloor_area_sqmintegerland_area_sqmintegerdecade_builtstringownership_typestringlegal_descriptionstringimagesstring[]estimateobjectrental_estimateobjectvaluesobjectagentsobject[]agencyobjectsuburb_idintegercity_idinteger
1c260d365-cdc8-422e-b6c3-a925a0579ef3c260d365-cdc8-422e-b6c3-a925a0579ef318886331-d922-4e17-b3be-269b4469f9f2salehttps://homes.co.nz/auckland/ponsonby/10-ardmore-road/axPjyAuction on 10 Dec, 2:00 pmfalseNZD2026-11-10T21:38:59.663Z2026-11-10T21:38:59.663ZVilla Extraordinaire...{5 fields}{2 fields}3241806291900FreeholdLOT 5 BLK 2 DP 2954 629M2[3 items]{4 fields}{4 fields}{4 fields}[1 item]{6 fields}1279100004
26c1a0dee-0388-4e3d-86e9-a5c3c26e3e156c1a0dee-0388-4e3d-86e9-a5c3c26e3e15ad8cc020-aea4-4165-bf20-72e015591e9esalehttps://homes.co.nz/auckland/ponsonby/8-lincoln-street/K7VABAuction on 17 Dec, 2:00 pmfalseNZD2026-11-10T21:37:22.543Z2026-11-10T21:37:22.543ZPonsonby Charmer...{5 fields}{2 fields}62—2463691900FreeholdPT LOT 39 ALLOT 31 SEC 8 SUBURBS AUCKLAND 369M2, PT LOT 41 ALLOT 31 SEC 8 SU[3 items]{4 fields}—{4 fields}[1 item]{6 fields}1279100004
3f31a79f1-d3b4-4235-b480-fd9e9bf7d329f31a79f1-d3b4-4235-b480-fd9e9bf7d3297bcec25c-a428-4557-b801-f0eacef8c0a2salehttps://homes.co.nz/auckland/ponsonby/37-wanganui-avenue/4j5LAuction on 2 Dec, 2:00 pmfalseNZD2026-11-10T01:16:35.817Z2026-11-10T01:16:35.817ZClassic character, bright future{5 fields}{2 fields}4111364161910FreeholdLOT 34 BLK 2 DP 3365 416M2[3 items]{4 fields}{4 fields}{4 fields}[1 item]{6 fields}1279100004

Recorded from our API · 3 items shown · 29 datapoints per itemGET /v1/homes-co-nz/search?type=sale&q=ponsonby&bedrooms_min=3

29 datapoints

Identity

  • idstring
  • listing_idstring
  • property_idstring
  • listing_typestring
  • suburb_idinteger

Contact

  • urlurl
  • ownership_typestring
  • agentsobject[]

Location

  • addressobject
  • floor_area_sqminteger
  • land_area_sqminteger
  • city_idinteger

Reputation

  • imagesstring[]

Price

  • display_pricestring
  • price_knownboolean
  • currencystring

Other

  • datestring
  • featured_atstring
  • headlinestring
  • coordinatesobject
  • bedroomsinteger
  • bathroomsinteger
  • car_spacesnumber
  • decade_builtstring
  • legal_descriptionstring
  • estimateobject
  • rental_estimateobject
  • valuesobject
  • agencyobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/homes-co-nz/search?type=sale&q=ponsonby&bedrooms_min=3" \
  -H "X-API-Key: $API_KEY"

homes.co.nz · 6 endpoints

Endpoints

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

EndpointRequired parametersCost
GET/v1/homes-co-nz/agency
id
1 credit
GET/v1/homes-co-nz/agent
id
1 credit
GET/v1/homes-co-nz/autocomplete
q
1 credit
GET/v1/homes-co-nz/listing
none+2 optional
1 credit
GET/v1/homes-co-nz/property
property_id+1 optional
1 credit
GET/v1/homes-co-nz/search
type+14 optional
1 credit

Overview

What you can get

The homes.co.nz API returns New Zealand property data from homes.co.nz as JSON through 6 endpoints.

  • Search: search takes a type (sale, sold, off_market or rent), with q, bbox, polyline, bedrooms_min, bedrooms_max, bathrooms_min, bathrooms_max, price_min, price_max, date_min, date_max, sort (date), page and per_page.
  • Listings and properties: listing takes an id or a url; property takes a property_id, with month_limit.
  • Agents and agencies: agent and agency take an id.
  • Locations: autocomplete takes a q.

The recorded search for homes for sale in Ponsonby with at least 3 bedrooms returns data.items, each with id, listing_id, property_id, listing_type, url, display_price, price_known, headline, address, coordinates, bedrooms, bathrooms, car_spaces, floor_area_sqm, land_area_sqm, decade_built, ownership_type, legal_description, images, estimate, rental_estimate, values (capital, land and improvement value), agents and agency. It also returns search_area (Ponsonby, Auckland) and pagination with has_more.

How a call works

Search a suburb: GET /v1/homes-co-nz/search?type=sale&q=ponsonby&bedrooms_min=3 with your key in the X-API-Key header. Each item's id goes to listing and its property_id to property; its agency and each of its agents carry the id that agency and agent take. Page with page while has_more is true. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices and sold homes by suburb with `type=sale` or `sold`

Use the homes.co.nz API to track asking prices and sold homes by suburb with `type=sale` or `sold`

Compare listing prices with each home's `estimate` and `values`

Use the homes.co.nz API to compare listing prices with each home's `estimate` and `values`

Size rental yields from `rental_estimate`

Use the homes.co.nz API to size rental yields from `rental_estimate`

Watch off-market homes with `type=off_market`

Use the homes.co.nz API to watch off-market homes with `type=off_market`

FAQ

Questions

Do I need a homes.co.nz account?

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

How much does the homes.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.

Does it cover homes that are not for sale?

Yes. `search` takes `type=off_market` and `type=sold`, and `property` takes the `property_id` that every search result carries.

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

You can, but a homes.co.nz scraper is code you maintain: page changes break it, requests get blocked, and homes.co.nz's terms govern how you collect data. The homes.co.nz API gives you 6 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 homes.co.nz API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs