होम
ब्लॉग
如何获取房产列表
ब्लॉग

如何获取房产列表

如何获取房产列表

您需要获取一个干净、可过滤的澳大利亚房产列表，并在本周内交付。通过本指南的结束，您将能够查询真实的房产信息，分页浏览结果，提取您关心的房产详情，并可选择深入了解单个房产——所有这些都通过 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/>度假村的两侧被运河环绕，非常适合钓鱼或划船，…

क्या आप Zyla API HUB का उपयोग करने के लिए तैयार हैं?

अभी आज़माएँ!

संबंधित पोस्ट्स

साइट ट्रैफ़िक एपीआई के लिए उपयोग के मामले

साइट ट्रैफ़िक एपीआई के लिए उपयोग के मामले

आपके हितधारक एक डैशबोर्ड चाहते हैं जो दिखाता है कि ट्रैफ़िक कहाँ से आता है, कौन से देश महत्वपूर्ण हैं, और आगंतुक कितने स...

 वीडियो डाउनलोड करने के लिए API

वीडियो डाउनलोड करने के लिए API

आपको प्रोग्रामेटिक रूप से वीडियो फ़ाइलों को डाउनलोड करने के लिए एक API की आवश्यकता है और इसे इस सप्ताह भेजना है। इस गाइड...

 फोन सत्यापन के लिए API

फोन सत्यापन के लिए API

आपके पास फॉर्म, चेकआउट और CRM से आने वाले फोन नंबर हैं, और आपको यह जानने की आवश्यकता है कि क्या वे मान्य हैं, मोबाइल हैं...

 कैसे प्रॉपर्टीज़ सूची प्राप्त करें

कैसे प्रॉपर्टीज़ सूची प्राप्त करें

आपको ऑस्ट्रेलियाई प्रॉपर्टीज़ की एक साफ, फ़िल्टर करने योग्य सूची प्राप्त करने की आवश्यकता है और इसे इस सप्ताह भेजना है।...

 कार्ड चेकर्स API के साथ काम करना

कार्ड चेकर्स API के साथ काम करना

आपको इस सप्ताह कार्ड BINs को मान्य और समृद्ध करना है ताकि आप जोखिम भरे भुगतानों को चिह्नित कर सकें, लेनदेन को सही ढंग से...

 वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए एपीआई

वीडियो डाउनलोड यूआरएल प्राप्त करने के लिए एपीआई

आपको इस सप्ताह एक सामाजिक मीडिया वीडियो यूआरएल को डाउनलोड करने योग्य फ़ाइल में बदलने के लिए एक विश्वसनीय तरीके की आवश्यक...

खोजें

संबंधित पोस्ट्स

हाल की पोस्ट्स