--- title: "homes.co.nz API: JSON data, 6 endpoints, 1 credit per call" description: "homes.co.nz API for New Zealand property search, listings, property records with estimates, agents and agencies as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/homes-co-nz --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / homes.co.nz 1 credit per call 6 endpoints 29 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id string | listing\_id string | property\_id string | listing\_type string | url url | display\_price string | price\_known boolean | currency string | date string | featured\_at string | headline string | address object | coordinates object | bedrooms integer | bathrooms integer | car\_spaces number | floor\_area\_sqm integer | land\_area\_sqm integer | decade\_built string | ownership\_type string | legal\_description string | images string\[\] | estimate object | rental\_estimate object | values object | agents object\[\] | agency object | suburb\_id integer | city\_id integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | c260d365-cdc8-422e-b6c3-a925a0579ef3 | c260d365-cdc8-422e-b6c3-a925a0579ef3 | 18886331-d922-4e17-b3be-269b4469f9f2 | sale | https://homes.co.nz/auckland/ponsonby/10-ardmore-road/axPjy | Auction on 10 Dec, 2:00 pm | false | NZD | 2026-11-10T21:38:59.663Z | 2026-11-10T21:38:59.663Z | Villa Extraordinaire... | {5 fields} | {2 fields} | 3 | 2 | 4 | 180 | 629 | 1900 | Freehold | LOT 5 BLK 2 DP 2954 629M2 | \[3 items\] | {4 fields} | {4 fields} | {4 fields} | \[1 item\] | {6 fields} | 1279 | 100004 | | 2 | 6c1a0dee-0388-4e3d-86e9-a5c3c26e3e15 | 6c1a0dee-0388-4e3d-86e9-a5c3c26e3e15 | ad8cc020-aea4-4165-bf20-72e015591e9e | sale | https://homes.co.nz/auckland/ponsonby/8-lincoln-street/K7VAB | Auction on 17 Dec, 2:00 pm | false | NZD | 2026-11-10T21:37:22.543Z | 2026-11-10T21:37:22.543Z | Ponsonby Charmer... | {5 fields} | {2 fields} | 6 | 2 | — | 246 | 369 | 1900 | Freehold | PT 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} | 1279 | 100004 | | 3 | f31a79f1-d3b4-4235-b480-fd9e9bf7d329 | f31a79f1-d3b4-4235-b480-fd9e9bf7d329 | 7bcec25c-a428-4557-b801-f0eacef8c0a2 | sale | https://homes.co.nz/auckland/ponsonby/37-wanganui-avenue/4j5L | Auction on 2 Dec, 2:00 pm | false | NZD | 2026-11-10T01:16:35.817Z | 2026-11-10T01:16:35.817Z | Classic character, bright future | {5 fields} | {2 fields} | 4 | 1 | 1 | 136 | 416 | 1910 | Freehold | LOT 34 BLK 2 DP 3365 416M2 | \[3 items\] | {4 fields} | {4 fields} | {4 fields} | \[1 item\] | {6 fields} | 1279 | 100004 | Recorded from our API · 3 items shown · 29 datapoints per item GET /v1/homes-co-nz/search?type=sale&q=ponsonby&bedrooms\_min=3 29 datapoints ### Identity - id string - listing\_id string - property\_id string - listing\_type string - suburb\_id integer ### Contact - url url - ownership\_type string - agents object\[\] ### Location - address object - floor\_area\_sqm integer - land\_area\_sqm integer - city\_id integer ### Reputation - images string\[\] ### Price - display\_price string - price\_known boolean - currency string ### Other - date string - featured\_at string - headline string - coordinates object - bedrooms integer - bathrooms integer - car\_spaces number - decade\_built string - legal\_description string - estimate object - rental\_estimate object - values object - agency object Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/homes-co-nz/agency`](https://perceptlayer.com/apis/homes-co-nz/agency) | `id` | 1 credit | | [GET `/v1/homes-co-nz/agent`](https://perceptlayer.com/apis/homes-co-nz/agent) | `id` | 1 credit | | [GET `/v1/homes-co-nz/autocomplete`](https://perceptlayer.com/apis/homes-co-nz/autocomplete) | `q` | 1 credit | | [GET `/v1/homes-co-nz/listing`](https://perceptlayer.com/apis/homes-co-nz/listing) | none +2 optional | 1 credit | | [GET `/v1/homes-co-nz/property`](https://perceptlayer.com/apis/homes-co-nz/property) | `property_id` +1 optional | 1 credit | | [GET `/v1/homes-co-nz/search`](https://perceptlayer.com/apis/homes-co-nz/search) | `type` +14 optional | 1 credit | Overview ## About the homes.co.nz API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)