新西兰房地产API提供了一种结构化和高效的方式来访问新西兰住宅物业的信息。它允许用户查看待售房屋的列表,并获取相关数据,如地址、郊区、城市、地区以及物业特征,包括卧室、浴室、停车位的数量,以及在某些情况下,土地或建筑面积。每个列表包含有关物业类型、出售状态的额外信息,以及在有的情况下,负责的代理的详细信息,使得用户能够轻松联系他们进行查询或看房。
除了单独的列表,API还提供搜索和过滤功能,允许用户根据特定标准(如位置、卧室数量或最近可用性)找到物业。这对于希望将物业搜索系统集成到网页或移动应用程序中的开发者尤其有用,为最终用户提供个性化和相关的体验。
该API还提供一般房地产市场统计数据,如物业总数、卧室分布、最活跃的地区及相关特征的平均值,使分析师和房地产代理能够理解不同地区的趋势和模式。这类数据对于评估供需情况、识别投资机会,以及基于可靠和最新信息做出战略决策非常有价值。
最后,最近的端点允许访问添加到数据库的最新列表,确保用户能够看到最新的物业。API返回的每个资源都带有创建和更新时间,确保信息的透明度和可追溯性。总体而言,该API被视为一个全面的工具,适合对新西兰住宅市场感兴趣的人士,提供详细的信息、统计数据和搜索功能,以集中和方便的方式呈现。
属性 - 端点功能
| 对象 | 描述 |
|---|---|
region |
[必需] Filter by region |
city |
可选 FIlter by city |
bedrooms |
可选 Indicate the number of bedrooms |
bathrooms |
可选 Indicate the number of bathrooms |
car_spaces |
可选 Filter by parking spaces |
property_types |
可选 Filter by property type (apartment, house, townhouse, unit) |
per_page |
可选 Indicates the number of results |
page |
可选 Indicates the number of the pagination |
{"success":true,"data":[{"listing_id":"42903452","title":"87 Gribblehirst Road, Sandringham, Auckland City","description":"A rendered brick villa with a striking black steel extension, 87 Gribblehirst Road is a home that blends original character with contemporary design, executed to the highest specification. Sheets and sheets would be needed to do this home justice in text - your immediate exploration of this dynamic offering is recommended. Locations, looks, and liveability like this are never available in the marketplace - until now. Act without delay.","address":"87 Gribblehirst Road, Sandringham, Auckland City","location":{"suburb":"Sandringham","city":"Sandringham","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-30T00:10:00"}},{"listing_id":"42910839","title":"6 Ventnor Road, Remuera, Auckland City","description":"Auction: 34 Shortland Street, City on Wednesday 26 November 2025 at 10:00AM (unless sold prior)","address":"6 Ventnor Road, Remuera, Auckland City","location":{"suburb":"Remuera","city":"Remuera","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-30T00:09:40"}},{"listing_id":"42866297","title":"210/199 Great North Road, Grey Lynn, Auckland City","description":"Vendor has reduced price. In the sought-after Crest Apartments, this one-bedroom residence sets the benchmark for quality and design. At 46sqm (approx.) plus a deck, it makes the most of its elevated position with views stretching to Mt Eden.","address":"210/199 Great North Road, Grey Lynn, Auckland City","location":{"suburb":"Grey Lynn","city":"Grey Lynn","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":1,"bathrooms":1,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-30T00:09:21"}},{"listing_id":"42479248","title":"14 Knight Avenue, Mount Albert, Auckland City","description":"For more information and to register your interest please visit http://knightterraces.co.nz","address":"14 Knight Avenue, Mount Albert, Auckland City","location":{"suburb":"Mount Albert","city":"Mount Albert","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-30T00:02:53"}},{"listing_id":"42913258","title":"535A Hillsborough Road, Mount Roskill, Auckland City","description":"A sanctuary of style, space, and sunlight, this modern home at 535A Hillsborough Road captures everything today’s buyers desire, effortless living, peaceful surroundings, and unbeatable convenience just minutes from the city.","address":"535A Hillsborough Road, Mount Roskill, Auckland City","location":{"suburb":"Mount Roskill","city":"Mount Roskill","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-30T00:00:47"}},{"listing_id":"42913030","title":"244C Victoria Avenue, Remuera, Auckland City","description":"Wake to morning light spilling through full-height windows, the scent of coffee filling the air as the day begins on prestigious Victoria Avenue. Children can stroll just steps to Victoria Avenue School, making school runs a breeze.","address":"244C Victoria Avenue, Remuera, Auckland City","location":{"suburb":"Remuera","city":"Remuera","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:51:01"}},{"listing_id":"42896111","title":"45B Elstree Avenue, Glen Innes, Auckland City","description":"Auction: 34 Shortland Street, City on Wednesday 29 October 2025 at 10:00AM (unless sold prior)","address":"45B Elstree Avenue, Glen Innes, Auckland City","location":{"suburb":"Glen Innes","city":"Glen Innes","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:49:13"}},{"listing_id":"42913093","title":"36 Omahu Road, Remuera, Auckland City","description":"Cookies, device or similar online identifiers (e.g. login-based identifiers, randomly assigned identifiers, network based identifiers) together with other information (e.g. browser type and information, language, screen size, supported technologies etc.) can be stored or read on your device to recognise it each time it connects to an app or to a website, for one or several of the purposes presented here.","address":"36 Omahu Road, Remuera, Auckland City","location":{"suburb":"Remuera","city":"Remuera","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":5,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:47:14"}},{"listing_id":"42746534","title":"I 202/11 Spring Street, Onehunga, Auckland City","description":"or visit: Fabric2.co.nz for more details.","address":"I 202/11 Spring Street, Onehunga, Auckland City","location":{"suburb":"Onehunga","city":"Onehunga","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":2,"bathrooms":2,"car_spaces":1,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:44:19"}},{"listing_id":"42897822","title":"176A Upland Road, Remuera, Auckland City","description":"Auction: 34 Shortland Street, City on Wednesday 29 October 2025 at 1:30PM (unless sold prior)","address":"176A Upland Road, Remuera, Auckland City","location":{"suburb":"Remuera","city":"Remuera","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":5,"bathrooms":2,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:41:28"}},{"listing_id":"42886918","title":"3A/89 Halsey Street, Wynyard Quarter, Auckland City - For Sale - realestate.co.nz","description":"Cookies, device or similar online identifiers (e.g. login-based identifiers, randomly assigned identifiers, network based identifiers) together with other information (e.g. browser type and information, language, screen size, supported technologies etc.) can be stored or read on your device to recognise it each time it connects to an app or to a website, for one or several of the purposes presented here.","address":"3A/89 Halsey Street, Wynyard Quarter, Auckland City","location":{"suburb":"Wynyard Quarter","city":"Wynyard Quarter","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:41:16"}},{"listing_id":"42892796","title":"9/58 Allendale Road, Mount Albert, Auckland City","description":"Cookies, device or similar online identifiers (e.g. login-based identifiers, randomly assigned identifiers, network based identifiers) together with other information (e.g. browser type and information, language, screen size, supported technologies etc.) can be stored or read on your device to recognise it each time it connects to an app or to a website, for one or several of the purposes presented here.","address":"9/58 Allendale Road, Mount Albert, Auckland City","location":{"suburb":"Mount Albert","city":"Mount Albert","region":"Auckland City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":1,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-29T19:22:04"}},{"listing_id":"42910636"}],"_note":"Response truncated for documentation purposes"}
curl --location --request GET 'https://zylalabs.com/api/11012/new+zealand+real+estate+api/20826/properties?region=Auckland&city=Christchurch&bedrooms=2&bathrooms=2&car_spaces=2&property_types=house&per_page=1&page=1' --header 'Authorization: Bearer YOUR_API_KEY'
提供房地产统计数据,包括总数、平均数、主要区域和卧室分布,并使用最新收集的数据进行更新分析
市场统计 - 端点功能
| 对象 | 描述 |
|---|
{"success":true,"data":{"general":{"total_properties":229,"total_regions":54,"total_cities":182,"avg_bedrooms":2.75,"avg_bathrooms":187365.22,"avg_car_spaces":187365.07,"last_scraped":"2025-10-30T00:11:21"},"top_regions":[{"region":"Auckland City","count":20},{"region":"North Shore City","count":17},{"region":"Thames-Coromandel","count":13},{"region":"Kapiti Coast","count":10},{"region":"Rodney","count":10},{"region":"Manukau City","count":10},{"region":"Hamilton City","count":9},{"region":"Queenstown","count":8},{"region":"Western Bay Of Plenty","count":7},{"region":"Taupo","count":7}],"bedrooms_distribution":[{"bedrooms":1,"count":4},{"bedrooms":2,"count":22},{"bedrooms":3,"count":76},{"bedrooms":4,"count":56},{"bedrooms":5,"count":17},{"bedrooms":6,"count":4},{"bedrooms":7,"count":3}]}}
curl --location --request GET 'https://zylalabs.com/api/11012/new+zealand+real+estate+api/20827/market+stats' --header 'Authorization: Bearer YOUR_API_KEY'
提供物业搜索结果,显示每个房源的关键信息,如位置、特点、物业类型和其他相关细节
搜索 - 端点功能
| 对象 | 描述 |
|---|---|
q |
[必需] Indicates a location |
page |
可选 Indicates the pagination |
per_page |
可选 Indicates the number of results |
{"success":true,"data":[{"listing_id":"42913427","title":"6 Tupuke Lane, Mount Roskill, Auckland City","description":"Cookies, device or similar online identifiers (e.g. login-based identifiers, randomly assigned identifiers, network based identifiers) together with other information (e.g. browser type and information, language, screen size, supported technologies etc.) can be stored or read on your device to recognise it each time it connects to an app or to a website, for one or several of the purposes presented here.","address":"6 Tupuke Lane, Mount Roskill, Auckland City","location":{"suburb":"Mount Roskill","city":"Mount Roskill","region":"Auckland City"},"features":{"bedrooms":3,"bathrooms":1,"car_spaces":1},"property_type":"House","agent_name":null,"created_at":"2025-11-02T00:17:38"},{"listing_id":"42913258","title":"535A Hillsborough Road, Mount Roskill, Auckland City","description":"A sanctuary of style, space, and sunlight, this modern home at 535A Hillsborough Road captures everything today’s buyers desire, effortless living, peaceful surroundings, and unbeatable convenience just minutes from the city.","address":"535A Hillsborough Road, Mount Roskill, Auckland City","location":{"suburb":"Mount Roskill","city":"Mount Roskill","region":"Auckland City"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:00:47"}],"search_term":"Mount Roskill","pagination":{"page":1,"per_page":20,"total":2,"pages":1}}
curl --location --request GET 'https://zylalabs.com/api/11012/new+zealand+real+estate+api/20828/search?q=Auckland&page=1&per_page=1' --header 'Authorization: Bearer YOUR_API_KEY'
最近 - 端点功能
| 对象 | 描述 |
|---|---|
limit |
[必需] Enter the number of results |
{"success":true,"data":[{"listing_id":"42908006","title":"394 South Road, CAVERSHAM, Dunedin City","address":"394 South Road, CAVERSHAM, Dunedin City","location":{"suburb":"CAVERSHAM","city":"CAVERSHAM","region":"Dunedin City"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:11:21"},{"listing_id":"42862746","title":"11 Fairway Drive, Morrinsville, Matamata-Piako","address":"11 Fairway Drive, Morrinsville, Matamata-Piako","location":{"suburb":"Morrinsville","city":"Morrinsville","region":"Matamata-Piako"},"features":{"bedrooms":3,"bathrooms":1,"car_spaces":2},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:11:11"},{"listing_id":"42894730","title":"49 Huihui A Wai Street, Kuratau, Taupo","address":"49 Huihui A Wai Street, Kuratau, Taupo","location":{"suburb":"Kuratau","city":"Kuratau","region":"Taupo"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:11:02"},{"listing_id":"42763668","title":"356 Matamau Ormondville Road RD7, Matamau, Tararua","address":"356 Matamau Ormondville Road RD7, Matamau, Tararua","location":{"suburb":"Matamau","city":"Matamau","region":"Tararua"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:10:49"},{"listing_id":"42902989","title":"24 Noeleen Street, Glenfield, North Shore City","address":"24 Noeleen Street, Glenfield, North Shore City","location":{"suburb":"Glenfield","city":"Glenfield","region":"North Shore City"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:10:41"},{"listing_id":"42862118","title":"12 Leburn Crescent, Flat Bush, Manukau City","address":"12 Leburn Crescent, Flat Bush, Manukau City","location":{"suburb":"Flat Bush","city":"Flat Bush","region":"Manukau City"},"features":{"bedrooms":0,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:10:31"},{"listing_id":"42862688","title":"26A Waterford Road, Katikati, Western Bay Of Plenty","address":"26A Waterford Road, Katikati, Western Bay Of Plenty","location":{"suburb":"Katikati","city":"Katikati","region":"Western Bay Of Plenty"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:10:20"},{"listing_id":"42904700","title":"24 Barrack Street, Whanganui, Whanganui","address":"24 Barrack Street, Whanganui, Whanganui","location":{"suburb":"Whanganui","city":"Whanganui","region":"Whanganui"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:10:10"},{"listing_id":"42903452","title":"87 Gribblehirst Road, Sandringham, Auckland City","address":"87 Gribblehirst Road, Sandringham, Auckland City","location":{"suburb":"Sandringham","city":"Sandringham","region":"Auckland City"},"features":{"bedrooms":4,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:10:00"},{"listing_id":"42910285","title":"58 Mapara Road, Acacia Bay, Taupo","address":"58 Mapara Road, Acacia Bay, Taupo","location":{"suburb":"Acacia Bay","city":"Acacia Bay","region":"Taupo"},"features":{"bedrooms":0,"bathrooms":0,"car_spaces":0},"property_type":"House","agent_name":null,"created_at":"2025-10-30T00:09:50"}],"limit":10}
curl --location --request GET 'https://zylalabs.com/api/11012/new+zealand+real+estate+api/20829/recent?limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
按上市ID的物业 - 端点功能
| 对象 | 描述 |
|---|---|
listing_id |
[必需] |
{"success":true,"data":{"listing_id":"42908006","title":"394 South Road, CAVERSHAM, Dunedin City","description":"Freshly updated and full of light, this beautifully presented three-bedroom home offers a fantastic opportunity for first-home buyers, young families, or investors looking for a low-maintenance option in a convenient city-fringe location.","address":"394 South Road, CAVERSHAM, Dunedin City","url":"https://www.realestate.co.nz/42908006/residential/sale/394-south-road-caversham","location":{"suburb":"CAVERSHAM","city":"CAVERSHAM","region":"Dunedin City","country":"New Zealand","postcode":"Unknown"},"features":{"bedrooms":3,"bathrooms":0,"car_spaces":0,"land_area":null,"floor_area":null},"property_info":{"property_type":"House","listing_type":"Sale","year_built":null},"agent":{"name":null,"company":null,"phone":null,"email":null},"dates":{"listed":null,"updated":null,"scraped":"2025-10-30T00:11:21"}}}
curl --location --request GET 'https://zylalabs.com/api/11012/new+zealand+real+estate+api/20830/property+by+listing+id&listing_id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
每个端点返回与新西兰房地产相关的特定数据 GET物业端点提供带有地址和特征的列表 GET市场统计提供关于物业的统计数据 GET搜索返回过滤后的物业结果 GET最近列出最新物业 GET按上市ID获取物业提供特定上市的详细信息
关键字段因端点而异 对于获取属性 字段包括地址 特征和物业类型 获取市场统计包括总物业 平均值和顶级区域 获取搜索和获取最近返回列表详情如位置和特征 而通过列表ID获取物业提供全面的详情包括描述 代理信息和日期
响应数据采用JSON格式结构。每个端点返回一个成功状态和一个数据对象。例如GET Market Stats返回一个包含总数和平均值的通用对象,而GET Properties返回一个包含每个具体细节(如地址和特点)的房产列表数组
获取属性端点提供带地址和特征的列表 获取市场统计提供整体市场统计信息,包括平均值和分布 获取搜索允许用户根据标准查找属性 获取最新显示最新列表 获取按上市ID获取特定属性的详细信息
参数因端点而异 GET搜索端点允许用户按位置 卧室数量和房产类型过滤结果 GET房产和GET最近不需要参数但返回所有房源 GET按房源ID获取房产需要一个特定的房源ID以检索详细信息
用户可以分析数据以识别趋势,例如平均房地产价格或热门地区。例如 GET市场统计可以帮助评估市场状况,而GET搜索可以用于查找符合特定标准的物业,从而提升用户在房地产应用中的体验
数据准确性通过定期更新和质量检查得以维护。该API从可靠的房地产列表中获取数据,并通过标记每个资源的创建和更新日期来确保信息是最新的,使用户能够跟踪数据的新鲜度
典型的使用案例包括开发房地产应用程序 进行市场分析 和协助买家寻找物业 分析师可以使用GET市场统计进行趋势分析 而开发人员可以集成GET搜索为用户提供定制的物业搜索体验
服务级别:
100%
响应时间:
956ms
服务级别:
100%
响应时间:
906ms
服务级别:
100%
响应时间:
304ms
服务级别:
100%
响应时间:
849ms
服务级别:
100%
响应时间:
1,939ms
服务级别:
100%
响应时间:
1,167ms
服务级别:
100%
响应时间:
389ms
服务级别:
100%
响应时间:
951ms
服务级别:
100%
响应时间:
6,109ms
服务级别:
100%
响应时间:
583ms