# Homes NZ Property Estimates API

> Homes.co.nz: New Zealand property estimates, rental yields and homes for sale near a point

- Vendor: `homesnzpropertyestimatesapi` · version 1.0 · category Property Data · tags homes.co.nz api, new zealand property api, nz house prices api, property valuation api, rental yield api, nz real estate api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/homesnzpropertyestimatesapi
- This document: https://apiclay.com/docs/homesnzpropertyestimatesapi.md
- OpenAPI 3.1: https://apiclay.com/api/homesnzpropertyestimatesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `homesnzpropertyestimatesapi`
- Updated: 2026-11-18

## About

## Homes NZ Property Estimates API

The property data behind homes.co.nz, New Zealand's free home-estimate site: properties near a latitude and longitude with the HomesEstimate value and range, rental estimate and yield, rateable capital, land and improvement values, bedrooms, bathrooms, car spaces, floor and land area, decade built, title and ownership type, sales count and photos; the featured listings for sale near a point with price, agent and branch; address and street search across New Zealand; and the date of the latest estimate run.

Data comes from **homes.co.nz** (https://homes.co.nz). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/address-search?Address=queen street` for coordinates, then `/nearby?lat=-36.8509&amp;long=174.7645&amp;limit=20` for estimated properties or `/featured?lat=...&amp;long=...&amp;size=24` for homes for sale.

### Routes

#### GET `/address-search` - Address search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| Address | query | string | yes | Address, street or place, e.g. `queen street` or `28 wellesley street east auckland`. |

Returns: `Results` array: `Title`, `Lat`, `Long`, `StreetNumber`, `Street`, `Suburb`, `City`, `SuburbID`, `CityID`, `Type` (3 = street), `Score`.

#### GET `/nearby` - Nearby properties
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lat | query | number | yes | Latitude, e.g. `-36.8509`. |
| long | query | number | yes | Longitude, e.g. `174.7645`. |
| limit | query | number | no | Properties to return, e.g. 20 (100 works). |

Returns: `cards` array: `property_id`, `sales_count`, `distance_to_point`, and `property_details` with `address`, `display_estimated_value_short` and lower/upper range, `estimated_rental_yield`, rental estimate range, `capital_value`, `land_value`, `improvement_value`, `num_bedrooms`, `num_bathrooms`, `num_car_spaces`, `floor_area`, `land_area`, `decade_built`, `ownership_type`, `legal_description`, images.

#### GET `/featured` - Featured listings
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lat | query | number | yes | Latitude. |
| long | query | number | yes | Longitude. |
| size | query | number | no | Listings to return, 15 to 30; smaller values give 15. |

Returns: `cards` array of homes for sale with the same `property_details`, plus `display_price`, `price`, `date`, `agent`, `agents` and `branches` (agency). About 9 KB per listing.

#### GET `/estimate-date` - Latest estimate date
No parameters.

Returns: `latest_date` of the most recent HomesEstimate run.

### Caveats

- Estimates are homes.co.nz's automated valuations, not registered valuations, and update about weekly. Listing agents' names and agency details are as published on the listing.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by homes.co.nz.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /address-search — Address search
- Gateway: `GET https://api.apiclay.com/v1/api/homesnzpropertyestimatesapi/address-search`
- Public query params: `Address` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /nearby — Nearby properties
- Gateway: `GET https://api.apiclay.com/v1/api/homesnzpropertyestimatesapi/nearby`
- Public query params: `lat` (number, required), `long` (number, required), `limit` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /featured — Featured listings
- Gateway: `GET https://api.apiclay.com/v1/api/homesnzpropertyestimatesapi/featured`
- Public query params: `lat` (number, required), `long` (number, required), `size` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /estimate-date — Latest estimate date
- Gateway: `GET https://api.apiclay.com/v1/api/homesnzpropertyestimatesapi/estimate-date`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/homesnzpropertyestimatesapi/address-search?Address=<Address>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
