--- title: "realestate.co.nz API: 7 endpoints, 1 credit per call" description: "realestate.co.nz API for New Zealand homes for sale or rent, listings, agents, offices, facets and location lookup as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/realestate-co-nz --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / realestate.co.nz 1 credit per call 7 endpoints 30 datapoints # realestate.co.nz API realestate.co.nz API for New Zealand homes for sale or rent, listings, agents, offices, facets and location lookup as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below realestate.co.nz GET /v1/realestate-co-nz/search?type=sale&rows=2®ion=35&bedrooms\_min=3&sort=latest ``` { "success": true, "data": { "total_count": 12353, "page": 1, "page_size": 2, "has_more": true, "max_results_per_query": 10000, "search_location": { "regions": [ "Auckland" ] }, "listings": [ { "id": 43171224, "listing_no": "944422", "url": "https://www.realestate.co.nz/43171224/residential/sale/50-baverstock-road-flat-bush", "title": "MORTGAGEE SALE", "status": "active", "category": "res_sale", "property_type": "House", "price_text": "Auction", "currency": "NZD", "price_code": 5, "auction_at": "2026-12-09T01:00:00Z", "auction_location": "18 Commerce St, Auckland City (Branch Office)", "address": { "full": "50 Baverstock Road, Flat Bush, Manukau City, Auckland", "display": "50 Baverstock Road, Flat Bush", "street_number": "50", "street": "Baverstock Road", "suburb": "Flat Bush", "district": "Manukau City", "region": "Auckland", "suburb_slug": "auckland_manukau-city_flat-bush_flat-bush", "district_slug": "auckland_manukau-city", "region_slug": "auckland", "latitude": -36.955940246582, "longitude": 174.91738891602 }, "bedrooms": 5, "bathrooms": 3, "land_area": 400, "land_area_unit": "sqm", "land_area_sqm": 400, "published_at": "2026-11-12T13:31:06Z", "created_at": "2026-11-12T13:31:02Z", "is_new_construction": false, "is_mortgagee_sale": true, "is_coastal_waterfront": false, "has_swimming_pool": false, "is_featured": false, "description": "MORTGAGEE AUCTION– 50 Baverstock Road, Flat Bush\n248m² of Family Living, One Great Location!\n\nNeed more room for the family? This five-bedroom home has approximately 248m² of floor area (according to Property Smarts) over two levels, on a 4…", "photo_count": 7, "photos": [ { "url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43171224/c81d6bdfad509ad55ee0c207b24940cc.crop.140x178.jpg" }, { "url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43171224/eb12db64ea1e788047a83fc708ed83d4.crop.140x178.jpg" }, { "url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43171224/85415ebda6e48eb3b3cbae22269ba7d9.crop.140x178.jpg" } ], "agents": [ { "id": 459473, "name": "Ari Tidyman", "first_name": "Ari", "last_name": "Tidyman", "slug": "ari-tidyman", "phone": "021 026 46621", "email": "a.tidyman@barfoot.co.nz", "website_url": "https://www.barfoot.co.nz/a.tidyman", "image": "…", "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - City Office", "listing_count": 24 }, { "id": 467732, "name": "Kristina Clarke", "first_name": "Kristina", "last_name": "Clarke", "slug": "kristina-clarke", "phone": "021 082 79272", "email": "k.clarke@barfoot.co.nz", "website_url": "https://www.barfoot.co.nz/k.clarke", "image": "…", "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - City Office", "listing_count": 11 } ], "office": { "id": 12647, "name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - City Office", "colloquial_name": "Barfoot & Thompson - City Office", "slug": "barfoot-thompson-ltd-licensed-reaa-2008-city-office", "phone": "09 307 6340", "email": "city@barfoot.co.nz", "logo_url": "https://mediaserver.realestate.co.nz/per_orgs/12647/28e841442d16d0273c207665f5a81896.jpg", "brand_colour": "#003572" } }, { "id": 43171223, "listing_no": "944072", "url": "https://www.realestate.co.nz/43171223/residential/sale/6-ridgeview-close-red-beach", "title": "The Ultimate Red Beach All-Rounder ", "status": "active", "category": "res_sale", "property_type": "House", "price_text": "Auction", "currency": "NZD", "price_code": 5, "auction_at": "2026-12-01T20:30:00Z", "auction_location": "8-12 The Promenade, Takapuna", "address": { "full": "6 Ridgeview Close, Red Beach, Rodney, Auckland", "display": "6 Ridgeview Close, Red Beach", "street_number": "6", "street": "Ridgeview Close", "suburb": "Red Beach", "district": "Rodney", "region": "Auckland", "suburb_slug": "auckland_rodney_red-beach_red-beach", "district_slug": "auckland_rodney", "region_slug": "auckland", "latitude": -36.606060028076, "longitude": 174.68858337402 }, "bedrooms": 4, "bathrooms": 2, "parking": { "garage": 2, "carport": 0, "off_street": 3 }, "land_area": 635, "land_area_unit": "sqm", "land_area_sqm": 635, "published_at": "2026-11-12T13:30:43Z", "created_at": "2026-11-12T13:30:39Z", "is_new_construction": false, "is_mortgagee_sale": false, "is_coastal_waterfront": false, "has_swimming_pool": false, "is_featured": false, "description": "Auction: 8-12 The Promenade, Takapuna on Wednesday 2 December 2026 at 9:30AM (unless sold prior)\n\n Positioned in one of Red Beach’s most sought-after pockets, 6 Ridgeview Close truly ticks every single box. Effortlessly blending low-mainte…", "photo_count": 31, "photos": [ { "url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43171223/d8e364c1f0fe67cad1dc50a0cda6bf54.crop.140x178.jpg" }, { "url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43171223/017506a67c8bb7664b54716197a201a9.crop.140x178.jpg" }, { "url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43171223/3adcfd30d80528949bd8d8eda7bd2b3b.crop.140x178.jpg" } ], "agents": [ { "id": 563543, "name": "Drue Matich", "first_name": "Drue", "last_name": "Matich", "slug": "drue-matich", "phone": "021 024 90448", "email": "d.matich@barfoot.co.nz", "website_url": "https://www.barfoot.co.nz/d.matich", "image": "…", "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - Whangaparaoa", "listing_count": 29 }, { "id": 886645, "name": "Danielle Bedford", "first_name": "Danielle", "last_name": "Bedford", "slug": "danielle-bedford", "phone": "021 263 8221", "email": "d.bedford@barfoot.co.nz", "website_url": "https://www.barfoot.co.nz/d.bedford", "image": "…", "office_name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - Whangaparaoa", "listing_count": 15 } ], "office": { "id": 14882, "name": "Barfoot & Thompson Ltd (Licensed: REAA 2008) - Whangaparaoa", "colloquial_name": "Barfoot & Thompson - Whangaparaoa", "slug": "barfoot-thompson-ltd-licensed-reaa-2008-whangaparaoa", "phone": "09 424 9199", "email": "whanga@barfoot.co.nz", "logo_url": "https://mediaserver.realestate.co.nz/per_orgs/14882/28e841442d16d0273c207665f5a81896.jpg", "brand_colour": "#003572" } } ] }, "meta": { "endpoint_family": "search", "request_id": "req_efa646d48f1e4a1e9fe817107ac9d85e", "credits_charged": 1, "credits_remaining": 1819 } } ``` 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 2 items. | # | id integer | listing\_no string | url url | title string | status string | category string | property\_type string | price\_text string | currency string | price\_code integer | auction\_at string | auction\_location string | address object | bedrooms integer | bathrooms integer | land\_area integer | land\_area\_unit string | land\_area\_sqm integer | published\_at string | created\_at string | is\_new\_construction boolean | is\_mortgagee\_sale boolean | is\_coastal\_waterfront boolean | has\_swimming\_pool boolean | is\_featured boolean | description string | photo\_count integer | photos object\[\] | agents object\[\] | office object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 43171224 | 944422 | https://www.realestate.co.nz/43171224/residential/sale/50-baverstock-road-flat-bush | MORTGAGEE SALE | active | res\_sale | House | Auction | NZD | 5 | 2026-12-09T01:00:00Z | 18 Commerce St, Auckland City (Branch Office) | {12 fields} | 5 | 3 | 400 | sqm | 400 | 2026-11-12T13:31:06Z | 2026-11-12T13:31:02Z | false | true | false | false | false | MORTGAGEE AUCTION– 50 Baverstock Road, Flat Bush 248m² of Family Living, One Great Location! Need more room for the family? This five-bedroom home has approximately 248m² of floor area (according to Property Smarts) over two levels, on a 4… | 7 | \[3 items\] | \[2 items\] | {8 fields} | | 2 | 43171223 | 944072 | https://www.realestate.co.nz/43171223/residential/sale/6-ridgeview-close-red-beach | The Ultimate Red Beach All-Rounder | active | res\_sale | House | Auction | NZD | 5 | 2026-12-01T20:30:00Z | 8-12 The Promenade, Takapuna | {12 fields} | 4 | 2 | 635 | sqm | 635 | 2026-11-12T13:30:43Z | 2026-11-12T13:30:39Z | false | false | false | false | false | Auction: 8-12 The Promenade, Takapuna on Wednesday 2 December 2026 at 9:30AM (unless sold prior) Positioned in one of Red Beach’s most sought-after pockets, 6 Ridgeview Close truly ticks every single box. Effortlessly blending low-mainte… | 31 | \[3 items\] | \[2 items\] | {8 fields} | Recorded from our API · 2 items shown · 30 datapoints per item GET /v1/realestate-co-nz/search?type=sale&rows=2®ion=35&bedrooms\_min=3&sort=latest 30 datapoints ### Identity - id integer - title string - status string - category string - property\_type string ### Contact - url url - agents object\[\] ### Location - auction\_location string - address object - land\_area integer - land\_area\_unit string - land\_area\_sqm integer ### Reputation - photo\_count integer - photos object\[\] ### Price - price\_text string - currency string - price\_code integer ### Other - listing\_no string - auction\_at string - bedrooms integer - bathrooms integer - published\_at string - created\_at string - is\_new\_construction boolean - is\_mortgagee\_sale boolean - is\_coastal\_waterfront boolean - has\_swimming\_pool boolean - is\_featured boolean - description string - office object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/realestate-co-nz/search?type=sale&rows=2®ion=35&bedrooms_min=3&sort=latest" \ -H "X-API-Key: $API_KEY" ``` realestate.co.nz · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/realestate-co-nz/agent`](https://perceptlayer.com/apis/realestate-co-nz/agent) | `id` +4 optional | 1 credit | | [GET `/v1/realestate-co-nz/autocomplete`](https://perceptlayer.com/apis/realestate-co-nz/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/realestate-co-nz/facets`](https://perceptlayer.com/apis/realestate-co-nz/facets) | `type` +3 optional | 1 credit | | [GET `/v1/realestate-co-nz/listing`](https://perceptlayer.com/apis/realestate-co-nz/listing) | `id` | 1 credit | | [GET `/v1/realestate-co-nz/locations`](https://perceptlayer.com/apis/realestate-co-nz/locations) | none | 1 credit | | [GET `/v1/realestate-co-nz/office`](https://perceptlayer.com/apis/realestate-co-nz/office) | `id` | 1 credit | | [GET `/v1/realestate-co-nz/search`](https://perceptlayer.com/apis/realestate-co-nz/search) | `type` +31 optional | 1 credit | Overview ## About the realestate.co.nz API ## What you can get The realestate.co.nz API returns realestate.co.nz property data as JSON through 7 endpoints. - **Search:** `search` takes a `type` (sale or rent), with `page`, `rows`, `region`, `district`, `suburb`, `agent`, `office`, `school`, `price_min`, `price_max`, `bedrooms_min`, `bedrooms_max`, `bathrooms_min`, `bathrooms_max`, `carparks`, `land_area_min`, `land_area_max`, `floor_area_min`, `floor_area_max`, `property_type`, `keyword`, `sort` (best-match, featured, latest, oldest, lowest-price, highest-price, lowest-land-area or highest-land-area), and the true-or-false filters `open_home`, `new_construction`, `mortgagee_sale`, `swimming_pool`, `pets_allowed`, `floor_plans`, `videos`, `coastal_waterfront` and `include_nearby_suburbs`. `facets` takes a `type`, with `region`, `district` and `suburb`. - **Listings:** `listing` takes an `id`. - **Agents and offices:** `agent` takes an `id`, with `include_listings`, `type` (sale or rent), `page` and `rows`; `office` takes an `id`. - **Locations:** `autocomplete` takes a `q`, with `type`; `locations` takes no parameters. The recorded `search` for homes for sale in region 35 (Auckland) with at least three bedrooms, sorted by `latest` with 2 `rows`, returns `listings` with `id`, `listing_no`, `url`, `title`, `status`, `category`, `property_type`, `price_text`, `currency`, `auction_at`, `auction_location`, `address`, `bedrooms`, `bathrooms`, `land_area`, `land_area_sqm`, `published_at`, `is_new_construction`, `is_mortgagee_sale`, `is_coastal_waterfront`, `has_swimming_pool`, `is_featured`, `description`, `photo_count`, `photos`, `agents` and `office`. It also returns `total_count` (12,353), `page_size`, `has_more` and `max_results_per_query`. ## How a call works Search a region: `GET /v1/realestate-co-nz/search?type=sale®ion=35&bedrooms_min=3&sort=latest&rows=2` with your key in the `X-API-Key` header. Each listing's `id` is what `listing` takes; each of its `agents` carries the `id` that `agent` takes, and its `office.id` is what `office` takes. 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 new listings for sale or rent in Auckland or another New Zealand region `Use the realestate.co.nz API to track new listings for sale or rent in Auckland or another New Zealand region` ### Watch mortgagee sales with \`mortgagee\_sale=true\` `` Use the realestate.co.nz API to watch mortgagee sales with `mortgagee_sale=true` `` ### Plan auctions from \`auction\_at\` and \`auction\_location\` `` Use the realestate.co.nz API to plan auctions from `auction_at` and `auction_location` `` ### Search homes near a school with \`school\` `` Use the realestate.co.nz API to search homes near a school with `school` `` FAQ ## Questions **Do I need a realestate.co.nz account?** No. You call this realestate.co.nz API with your Perceptlayer key in the \`X-API-Key\` header, with no realestate.co.nz login. **How much does the realestate.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. **How many results can one search return?** The recorded Auckland search reports a \`total\_count\` of 12,353 and a \`max\_results\_per\_query\` of 10,000. Narrow by district, suburb, price or bedrooms to reach the rest. **Should I build a realestate.co.nz scraper instead?** You can, but a realestate.co.nz scraper is code you maintain: page changes break it, requests get blocked, and realestate.co.nz's terms govern how you collect data. The realestate.co.nz API gives you 7 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 realestate.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)