如何获取房产列表

您需要获取一个干净、可过滤的澳大利亚房产列表，并在本周内交付。通过本指南的结束，您将能够查询真实的房产信息，分页浏览结果，提取您关心的房产详情，并可选择深入了解单个房产——所有这些都通过 Zyla API Hub 上的一个 API 密钥完成。

您可以用房产列表构建什么

澳大利亚房地产 API 返回包含元数据的结构化房产列表，如总结果计数、解析的搜索地点和分级列表。典型用途包括：

• 构建一个搜索 UI，以按地区或郊区探索已售或租赁历史。
• 生成按最新房源排序的每日房产摘要或警报。
• 用房源计数和分页感知的获取丰富内部仪表板。

本文重点介绍“获取房产列表”端点，以返回带有过滤和排序的房源页面，并展示如何在需要时检索特定房产的详细信息。

在 Zyla API Hub 上开始

在 Zyla 上，您使用一个帐户、一个 API 密钥，以及每个 API 的订阅 + 配额模型。对于澳大利亚房地产 API，您可以根据当前访问选项选择 7 天试用或 50 次请求。没有免费计划；请查看 API 页面以获取当前访问选项和定价。

步骤：

1. 打开 Zyla 上的澳大利亚房地产 API 页面。
2. 点击订阅或开始免费试用（如果可用）以获取您的密钥。
3. 使用头部 Authorization: Bearer YOUR_API_KEY 调用端点。

澳大利亚房地产 API 概述

澳大利亚房地产 API 暴露端点以：

• 列出带有过滤和排序的房产（获取房产列表）。
• 获取特定房产的详细信息（获取房产详情）。
• 自动完成位置以驱动搜索用户体验（自动完成）。

您将在 Zyla 上使用真实的 Hub URL。请勿添加未记录的参数。当从房源结果中呈现图像时，您必须在图像 URL 路径中直接指定目标大小（例如，170x32、160x30、114x21、1536x800）。

端点：获取房产列表

列出带有选项和过滤的房产。使用此功能按地点搜索，切换渠道（例如，已售），控制排序和分页。

• 方法：GET
• URL：https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list

请求参数

• channel（字符串，必需）：sold
• searchLocation（字符串，必需）：Sunshine Coast, QLD
• searchLocationSubtext（字符串，必需）：Region
• type（字符串，必需）：region
• pageSize（字符串，选填）：50
• page（字符串，选填）：2
• sortType（字符串，选填）：new-desc

分页说明：如果页面字段返回值为 50，则这是当前查询的最高可用页面编号。

官方 cURL 示例

curl -s -X GET "https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list?pageSize=50&channel=sold&searchLocation=Sunshine+Coast%2C+QLD&searchLocationSubtext=Region&type=region&page=2&sortType=new-desc" \
-H "Authorization: Bearer YOUR_API_KEY"

官方 JSON 响应

{
"prettyUrl": "/sold/in-sunshine+coast%2c+qld/list-2?activeSort=list-date",
"totalResultsCount": 162134,
"resolvedLocalities": [
{
"display": "Sunshine Coast, QLD",
"precision": "region",
"atlasId": "9280a900-d539-4e0c-9385-9590315c4cb5",
"state": "QLD"
}
],
"resolvedQuery": {
"localities": [
{
"locality": "Sunshine Coast",
"subdivision": "QLD",
"searchLocation": "Sunshine Coast, QLD"
}
],
"sortType": "new-desc",
"channel": "sold",
"pageSize": "30",
"page": "2",
"filters": {
"surroundingSuburbs": true
}
},
"tieredResults": [
{
"tier": 1,
"count": 30,
"results": [
{
"prettyUrl": "property-unit-qld-mudjimba-122053054",
"standard": true,
"midtier": false,
"lister": {
"mobilePhoneNumber": "0402972763",
"website": "http://www.bluemoonproperty.com.au",
"phoneNumber": "0402972763",
"powerProfile": false,
"jobTitle": "Sales Consultant",
"name": "Beatrice Borns",
"mainPhoto": {
"server": "https://i3.au.reastatic.net",
"name": "main photo",
"uri": "/ca783e0f628a14ff14b48ea8e53a7432f9c5b8f5676004cc2f8fecbfdc27ca95/main.jpg"
},
"id": "1405426",
"email": "[email protected]"
},
"featured": false,
"signature": false,
"constructionStatus": "established",
"channel": "sold",
"description": "为什么要为假期支付一大笔钱，当您可以拥有自己在美丽的阳光海岸上度假风格生活的一部分。<br/>利用游泳池、2 个网球场、推杆区、河边的烧烤区和儿童的独立游乐场。<br/><br/>这栋 3 卧室的联排别墅位于宠物友好的封闭安全度假村，距离美丽的 Mudjimba 海滩仅 2 公里。<br/>度假村的两侧被运河环绕，非常适合钓鱼或划船，…

从响应中读取内容

• totalResultsCount：所有页面中匹配的房源总数，适用于分页控制。
• resolvedLocalities 和 resolvedQuery：服务器对您搜索的解释（地点、渠道、页面、排序）。
• tieredResults[0].count 和 tieredResults[0].results：当前页面上的房源。
• 每个 result.lister 包含代理联系信息和 mainPhoto。要请求图像，请在 URL 路径中包含支持的大小。例如：server + "/1536x800" + uri。

图像大小要求：您必须在图像 URL 中指明格式（大小）。支持的示例包括 170x32、160x30、114x21、1536x800。例如：https://i3.au.reastatic.net/1536x800/ca783e0....../main.jpg

Python 示例：获取和解析房产列表

此代码段调用上述确切端点，打印总结果计数，然后迭代第一层结果以提取一些实用字段。

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/1476/australia-realty-api/1221/get-properties-list"
params = {
"pageSize": "50",
"channel": "sold",
"searchLocation": "Sunshine Coast, QLD",
"searchLocationSubtext": "Region",
"type": "region",
"page": "2",
"sortType": "new-desc",
}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()

print("总结果：", data.get("totalResultsCount"))

tiers = data.get("tieredResults", [])
if tiers:
tier0 = tiers[0]
print("此页面上的房源：", tier0.get("count"))
for item in tier0.get("results", []):
pretty = item.get("prettyUrl")
channel = item.get("channel")
lister = item.get("lister", {})
agent = lister.get("name")
main_photo = lister.get("mainPhoto", {})
server = main_photo.get("server")
uri = main_photo.get("uri")
# 按照 API 图像格式规则构建 1536x800 图像 URL。
image_url = None
if server and uri:
image_url = f"{server}/1536x800{uri}"
print({
"prettyUrl": pretty,
"channel": channel,
"agent": agent,
"image": image_url
})

实用集成注意事项

• 分页：使用页面参数进行迭代。如果响应的页面字段指示 50，则这是该查询的最高页面。
• 排序：sortType=new-desc 返回指定渠道的最新内容。
• 图像：在路径中始终包含明确的大小。存储服务器和 uri，但在呈现时构建特定大小的 URL。
• 缓存：通过完整的查询参数集（包括页面）缓存搜索，以避免在会话期间重新获取未修改的页面。

端点：获取房产详情

当用户点击房源时，请请求该特定房产的详细信息。

• 方法：GET
• URL：https://zylalabs.com/api/1476/australia-realty-api/1222/get-property-details

请求参数

• id（数字，必需）：444325280

cURL

示例响应

{"totalResultsCount":1,"results":[{"prettyUrl":"property-unit-qld-east+brisbane-444325280","standard":false,"midtier":false,"lister":{"mobilePhoneNumber":"0415648373","website":"http://www.housemark.com.au","phoneNumber":"0415648373","powerProfile":false,"name":"Isabella Palinkas","mainPhoto":{"server":"https://i3.au.reastatic.net","name":"main photo","uri":"/10082ec1487f85957c4f7062944636ee7600a93bdaf34549cb5f2705c1250f13/main.jpg"},"id":"3706692","email":"[email protected]"},"featured":false,"signature":true,"channel":"rent","description":"欢迎来到 4/8 Longlands Street, East Brisbane！距离 The Gabba 仅几步之遥，周围有各种咖啡馆、商店、交通选择和主要设施，这个家非常适合那些寻求轻松的市中心生活的人。<br/><br/>最近经过全面的室内翻新，这个美丽的更新单元已准备好让新主人享受。整个房屋都进行了新粉刷，配备了全新的厨房、翻新的浴室和洗衣房，以及全新的地板，每个细节都经过精心现代化。结合舒适性、功能性和现代魅力，这是一个出色的机会，适合那些寻求…"}

与列表响应一样，通过在路径中插入支持的大小来构建图像 URL：server + "/1536x800" + uri（或其他支持的大小）。

端点：自动完成

使用此功能为搜索输入提供建议的地区或郊区。此端点要求您指定要自动完成的术语；此处未记录请求参数。发送您的授权头。

• 方法：GET
• URL：https://zylalabs.com/api/1476/australia-realty-api/5339/autocomplete

cURL

示例响应

{"_embedded":{"suggestions":[{"display":{"subtext":"Region","text":"Sydney CBD, NSW"},"id":"6102b706-7216-4cde-b780-45cba0514ac5","source":{"atlasId":"6102b706-7216-4cde-b780-45cba0514ac5","name":"Sydney CBD","state":"NSW"},"type":"region"},{"display":{"subtext":"Suburb","text":"Sydney, NSW 2000"},"id":"99b291a3-bfcf-4bf9-bbaa-bdb9d89abc24-2000","source":{"atlasId":"99b291a3-bfcf-4bf9-bbaa-bdb9d89abc24","name":"Sydney","postcode":"2000","state":"NSW"},"type":"suburb"},{"display":{"subtext":"Suburb","text":"Sydney Olympic Park, NSW 2127"},"id":"19174a2e-3f53-4be4-8477-443d47249f20-2127","source":{"atlasId":"19174a2e-3f53-4be4-8477-443d47249f20","name":"Sydney Olympic Park","postcode":"2127","state":"NSW"},"type":"suburb"},{"display":{"subtext":"Region","text":"Western Sydney, NSW"},"id":"637c2a12-9141-4e1d-adfa-30bd200a49a4","source":{"atlasId":"637c2a12-9141-4e1d-adfa-30bd200a49a4","name":"Western Sydney","state":"NSW"},"type":"region"},{"display":{"subtext":"Region","text":"South Western Sydney, NSW"},"id":"0eadb86e-6345-43b6-ab6d-18e17c779817","source":{"atlasId":"0eadb86e-6345-43b6-ab6d-18e17c779817","name":"South Western Sydney","state":"NSW"},"type":"region"},{"display":{"subt…

快速交付的真实工作流程

房产搜索页面（按地区出售的房源）

1. 自动完成用户的输入，以捕获 type=suburb 或 type=region 及显示文本。
2. 调用获取房产列表，渠道=sold，类型和搜索位置完全匹配您选择的建议，并适当设置 searchLocationSubtext（例如，Region）。
3. 根据 totalResultsCount 和 page 渲染 tieredResults[0].results 和分页器。
4. 使用 mainPhoto.server + "/1536x800" + mainPhoto.uri 为每个项目构建图像 URL。

深入了解单个房产

1. 从结果中，通过您应用的路由中的 prettyUrl 导航，并存储/显示基本信息。
2. 调用获取房产详情，使用 id 获取更深入的描述和列出的联系信息。
3. 重用图像大小规则，用于主图像和缩略图。

每日更新或警报管道

• 按目标地点调度获取房产列表，sortType=new-desc。
• 跟踪每个地点观察到的最大 prettyUrl 或 ID，以避免重复。
• 发送通知，包含列出的名称和预先大小的图像 URL。

从 AI 代理调用 API（MCP）

如果您更喜欢从 AI 编码环境中协调调用，Zyla 提供了一个模型上下文协议端点，适用于与 MCP 兼容的客户端。配置您的客户端以调用 MCP 端点并使用您的 Zyla API 密钥。请参阅此处的文档：

MCP

任何使用 MCP 的工具/代理都可以执行上述相同的 HTTP 请求，使用 Authorization: Bearer 头和记录的 URL 和参数。

故障排除和集成提示

• 授权：始终包括 Authorization: Bearer YOUR_API_KEY。省略其他未记录的密钥。
• 参数保真度：仅使用每个端点记录的参数。例如，channel、searchLocation、searchLocationSubtext 和 type 是获取示例列表所需的。
• 分页上限：当响应指示页面 50 为该查询的最高页面时停止分页。
• 图像呈现：如果图像加载失败，请确认您在 uri 之前的路径中插入了支持的大小。
• 配额：使用遵循订阅 + 配额，而不是按调用付费。监控调用以保持在当前计划内。

常见问题

我如何进行身份验证？
每次请求时发送 Authorization: Bearer YOUR_API_KEY。

获取房产列表需要哪些参数？
channel、searchLocation、searchLocationSubtext 和 type 是必需的。pageSize、page 和 sortType 是可选的。

我可以请求的最大页面是多少？
如果响应的页面字段返回 50，则这是该查询的最高分页编号。

我如何加载房源图像？
使用 lister.mainPhoto 字段并在路径中插入支持的大小：server + "/1536x800" + uri（或其他记录的大小之一）。

是否有免费计划？
没有免费计划。第一个 API 通常提供 7 天试用或 50 次请求；请查看 API 页面以获取当前访问选项和定价。

开始 7 天试用澳大利亚房地产 API 以获取您的密钥并使用上述端点交付您的集成。

官方 API 响应

{
"prettyUrl": "/sold/in-sunshine+coast%2c+qld/list-2?activeSort=list-date",
"totalResultsCount": 162134,
"resolvedLocalities": [
{
"display": "Sunshine Coast, QLD",
"precision": "region",
"atlasId": "9280a900-d539-4e0c-9385-9590315c4cb5",
"state": "QLD"
}
],
"resolvedQuery": {
"localities": [
{
"locality": "Sunshine Coast",
"subdivision": "QLD",
"searchLocation": "Sunshine Coast, QLD"
}
],
"sortType": "new-desc",
"channel": "sold",
"pageSize": "30",
"page": "2",
"filters": {
"surroundingSuburbs": true
}
},
"tieredResults": [
{
"tier": 1,
"count": 30,
"results": [
{
"prettyUrl": "property-unit-qld-mudjimba-122053054",
"standard": true,
"midtier": false,
"lister": {
"mobilePhoneNumber": "0402972763",
"website": "http://www.bluemoonproperty.com.au",
"phoneNumber": "0402972763",
"powerProfile": false,
"jobTitle": "Sales Consultant",
"name": "Beatrice Borns",
"mainPhoto": {
"server": "https://i3.au.reastatic.net",
"name": "main photo",
"uri": "/ca783e0f628a14ff14b48ea8e53a7432f9c5b8f5676004cc2f8fecbfdc27ca95/main.jpg"
},
"id": "1405426",
"email": "[email protected]"
},
"featured": false,
"signature": false,
"constructionStatus": "established",
"channel": "sold",
"description": "为什么要为假期支付一大笔钱，当您可以拥有自己在美丽的阳光海岸上度假风格生活的一部分。<br/>利用游泳池、2 个网球场、推杆区、河边的烧烤区和儿童的独立游乐场。<br/><br/>这栋 3 卧室的联排别墅位于宠物友好的封闭安全度假村，距离美丽的 Mudjimba 海滩仅 2 公里。<br/>度假村的两侧被运河环绕，非常适合钓鱼或划船，…

官方 API 响应

{
"prettyUrl": "/sold/in-sunshine+coast%2c+qld/list-2?activeSort=list-date",
"totalResultsCount": 162134,
"resolvedLocalities": [
{
"display": "Sunshine Coast, QLD",
"precision": "region",
"atlasId": "9280a900-d539-4e0c-9385-9590315c4cb5",
"state": "QLD"
}
],
"resolvedQuery": {
"localities": [
{
"locality": "Sunshine Coast",
"subdivision": "QLD",
"searchLocation": "Sunshine Coast, QLD"
}
],
"sortType": "new-desc",
"channel": "sold",
"pageSize": "30",
"page": "2",
"filters": {
"surroundingSuburbs": true
}
},
"tieredResults": [
{
"tier": 1,
"count": 30,
"results": [
{
"prettyUrl": "property-unit-qld-mudjimba-122053054",
"standard": true,
"midtier": false,
"lister": {
"mobilePhoneNumber": "0402972763",
"website": "http://www.bluemoonproperty.com.au",
"phoneNumber": "0402972763",
"powerProfile": false,
"jobTitle": "Sales Consultant",
"name": "Beatrice Borns",
"mainPhoto": {
"server": "https://i3.au.reastatic.net",
"name": "main photo",
"uri": "/ca783e0f628a14ff14b48ea8e53a7432f9c5b8f5676004cc2f8fecbfdc27ca95/main.jpg"
},
"id": "1405426",
"email": "[email protected]"
},
"featured": false,
"signature": false,
"constructionStatus": "established",
"channel": "sold",
"description": "为什么要为假期支付一大笔钱，当您可以拥有自己在美丽的阳光海岸上度假风格生活的一部分。<br/>利用游泳池、2 个网球场、推杆区、河边的烧烤区和儿童的独立游乐场。<br/><br/>这栋 3 卧室的联排别墅位于宠物友好的封闭安全度假村，距离美丽的 Mudjimba 海滩仅 2 公里。<br/>度假村的两侧被运河环绕，非常适合钓鱼或划船，…