使用实时Zillow数据API

您的团队需要可以按城市、地图边界或绘制的多边形过滤的实时房地产库存，而您需要在本周内完成。通过本指南的结束，您将能够使用Zyla API Hub上的实时Zillow数据API按位置、坐标或自定义多边形提取实时Zillow风格的房源，解析您关心的字段（价格、卧室、浴室、估价、地址、坐标），并将其插入到您的应用程序或AI代理工作流中。

您可以使用实时Zillow数据API构建的内容

实时Zillow数据API公开了搜索端点，返回房产列表和元数据，例如zpid、地址、坐标、房屋类型、价格和货币、估价和租金估价、评估值、卧室、浴室、居住面积、在Zillow上的天数等。您可以：

• 按“洛杉矶，加州”等人类可读的位置搜索。
• 在纬度/经度周围的半径内搜索。
• 在任意多边形内搜索，以匹配复杂的邻里形状或自定义服务区域。

典型的集成包括买家/租户搜索应用、带有地理过滤器的代理仪表板、物业分析和即时比较工具。

在Zyla API Hub上开始

打开Zyla API Hub上的实时Zillow数据API列表并订阅以开始发出请求。Zyla使用订阅+配额模型（不是按调用付费）。对于此API，您可以直接从列表页面开始7天的试用。一个帐户和一个API密钥可以在超过10,000个公共API的目录中使用。

开始7天的实时Zillow数据API试用

订阅后，您将获得一个API密钥。使用以下标头对每个请求进行身份验证：Authorization: Bearer YOUR_API_KEY。

您将使用的端点

以下是三个可用的端点。每个端点返回JSON，包含状态、request_id、请求参数回显和房源数据数组。仅使用每个端点所示的参数。

1) 搜索 — 按城市、邻里、县或邮政编码

当您有一个人类可读的地点名称时使用此功能。它支持可选的分页和按房屋状态过滤。

• 方法：GET
• URL：https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• 所需查询参数：
  • location（字符串）：例如，洛杉矶，加州
• 可选查询参数：
  • page（字符串）：页码
  • home_status（字符串）：例如，FOR_SALE

cURL（官方示例）：

curl -s -X GET "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search?location=Los+Angeles%2C+CA&page=2&home_status=FOR_SALE" \
-H "Authorization: Bearer YOUR_API_KEY"

JSON（官方示例）：

{
"status": "OK",
"request_id": "81fc95df-86f3-44b7-a3dc-1d81abcd7a97",
"parameters": {
"page": 2,
"home_status": "FOR_SALE",
"sort": "DEFAULT",
"listing_type": "BY_AGENT",
"location": "Los Angeles, CA"
},
"data": [
{
"zpid": "136702358",
"homeStatus": "FOR_SALE",
"detailUrl": "https://www.zillow.com/homedetails/24425-Woolsey-Canyon-Rd-SPC-39-Canoga-Park-CA-91304/136702358_zpid/",
"address": "24425 Woolsey Canyon Rd Spc 39, Canoga Park, CA 91304",
"streetAddress": "24425 Woolsey Canyon Rd Spc 39",
"city": "Canoga Park",
"state": "CA",
"country": "USA",
"zipcode": "91304",
"latitude": 34.235462,
"longitude": -118.661224,
"homeType": "MANUFACTURED",
"price": 99500,
"currency": "USD",
"zestimate": 178100,
"rentZestimate": 3439,
"taxAssessedValue": 21901,
"bathrooms": 2,
"bedrooms": 4,
"livingArea": 1818,
"daysOnZillow": 5,
"isFeatured": false,
"isPreforeclosureAuction": false,
"timeOnZillow": 498172000,
"isNonOwnerOccupied": true,
"isPremierBuilder": false,
"isZillowOwned": false,
"unit": "Spc 39",
"isShowcaseListing": false,
"listingSubType": {
"is_FSBA": true
},
"palsId": "3007_SR26162189",
"id": "136702358",
"rawHomeStatusCd": "ForSale",
"marketingStatusSimplifiedCd": "For Sale by Agent",
"imgSrc": "https://photos.zillowstatic.com/fp/1d8602169bd359c27caa6d6e25cdf662-p_e.jpg",
"hasImage": true,
"statusType": "FOR_SALE",
"statusText": "房屋待售",
"countryCurrency": "$",
"unformattedPrice": 99500,
"addressStreet": "24425 Woolsey Canyon Rd Spc 39",
"addressCity": "Canoga Park",
"addressState": "CA",
"addressZipcode": "91304",
"isUndisclosedAddress": false,
"shouldShowRequestOnPrice": false,
"beds": 4,
"baths": 2,
"area": 1818,
"latLong": {
"latitude": 34.235462,
"longitude": -118.661224
},
"flexFieldText": "5 days on…

您将最常使用的内容：

• zpid（字符串）：稳定的物业标识符。
• detailUrl（字符串）：查看房源页面的深度链接。
• price、currency、zestimate、rentZestimate（数字和货币）：定价上下文。
• bedrooms、bathrooms、livingArea、area（数字）：房屋规格；当存在时，area/livingArea以平方英尺为单位。
• latitude、longitude和latLong：映射。
• homeStatus/statusType/statusText：房源状态信号（例如，FOR_SALE）。
• daysOnZillow/timeOnZillow：市场新鲜度。

Python示例（requests）：

import requests

url = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search"
params = {
"location": "Los Angeles, CA",
"page": "2",
"home_status": "FOR_SALE"
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

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

print("状态:", payload.get("status"))
print("请求ID:", payload.get("request_id"))

for item in payload.get("data", []):
zpid = item.get("zpid")
addr = item.get("address")
price = item.get("price")
beds = item.get("bedrooms") or item.get("beds")
baths = item.get("bathrooms") or item.get("baths")
lat = item.get("latitude") or (item.get("latLong") or {}).get("latitude")
lng = item.get("longitude") or (item.get("latLong") or {}).get("longitude")
detail = item.get("detailUrl")
print(f"[{zpid}] {addr} | ${price} | {beds} bd / {baths} ba | ({lat}, {lng}) -> {detail}")

2) 按坐标搜索 — 中心点 + 直径

使用此功能查找中心纬度/经度周围的圆形区域内的房产。对于“离我最近”的功能或靠近场地的功能非常有用。

• 方法：GET
• URL：https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• 所需查询参数：
  • long（字符串）：经度
  • lat（字符串）：纬度
• 可选查询参数：
  • diameter（字符串）：搜索直径

cURL：

示例JSON：

注意：

• 坐标为十进制度。确保查询参数的URL编码。
• 数据负载包括与搜索端点相同的核心字段。

3) 按多边形搜索 — 自定义区域边界

当圆形不够精确时使用此功能。提供一个多边形作为由逗号分隔的“经度 纬度”坐标对的序列。这对于匹配不规则的邻里、学区或服务区域非常理想。该端点支持Zillow.com上可用的所有过滤器和选项。

• 方法：GET
• URL：https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• 所需查询参数：
  • polygon（字符串）：由逗号分隔的有序“经度 纬度”对（见示例）

cURL：

示例JSON：

注意：

• 将每个顶点格式化为“经度 纬度”。用逗号分隔顶点。
• 对多边形字符串进行URL编码。上面的示例显示了使用“+”表示空格和“%2C”表示参数值内的逗号的正确编码。

实际实施细节

• 身份验证：始终包括Authorization: Bearer YOUR_API_KEY。
• 分页：在搜索和支持分页的端点上使用page参数以获取后续结果页面。API在参数对象中回显您请求的页面。
• 单位和货币：
  • 货币通常为“USD”。countryCurrency可能包括符号“$”。
  • 当lotAreaUnit为“sqft”时，livingArea/area和lotAreaValue值以平方英尺为单位。
• 过滤：home_status可以设置为FOR_SALE（如所示）。Zillow.com支持其他过滤器；请查阅API页面以获取当前选项。
• 坐标：纬度/经度为十进制度。
• 缓存：对于频繁更改的房源信息（daysOnZillow、价格更新），在用户交互时添加短期缓存和条件刷新。
• 深度链接：detailUrl可以在webview或外部浏览器中打开房源页面。
• 配额：访问是订阅+配额。请查看API页面以获取当前访问选项和定价。

您可以快速交付的实际用例

• 买家搜索页面：从按位置搜索开始，然后在用户在地图上绘制时切换到按多边形搜索。显示价格、卧室、浴室，并将每个卡片链接到detailUrl。
• 代理CMA/比较：使用按坐标搜索收集位于主题物业周围1-2英里直径内的房源；快速显示估价和租金估价以提供估值上下文。
• 邻里探索者：为每个邻里预定义多边形边界，并使用按多边形搜索进行查询，以确保结果尊重当地不规则边界。
• 移动“离我最近”：在位置权限下，使用用户的GPS位置调用按坐标搜索，设置小直径以保持结果相关。

通过MCP从AI代理调用此API

您还可以通过与MCP兼容的客户端驱动这些端点。将您的代理指向Zyla MCP端点，并使用相同的API密钥：

MCP

端点：https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

• 从您的MCP客户端，发出执行HTTPS GET请求的工具调用，指向上面显示的相同hub URL。
• 发送Authorization: Bearer YOUR_API_KEY标头，格式与curl示例完全相同。
• 保持查询字符串与此处的示例相同，以确保提示和代理流程中的稳定行为。

故障排除和注意事项

• 401或403错误：确认Authorization标头存在，并且API密钥对您的订阅有效。
• 空数据数组：验证您的过滤器是否过于严格；尝试删除home_status或调整多边形/直径。
• 多边形格式错误：确保每个点为“经度 纬度”，而不是“纬度 经度”，并且整个字符串已进行URL编码。
• 分页混淆：API在parameters.page下回显请求的页面。增加页面以遍历结果集。
• 编码空格和逗号：在URL中，空格应编码为+或%20，逗号应在查询参数值内编码为%2C。

常见问题

我如何对请求进行身份验证？
在每个请求中包含标头Authorization: Bearer YOUR_API_KEY。

我可以按房源状态过滤吗？
可以。在搜索和坐标/多边形搜索中设置home_status=FOR_SALE（如支持）。

我如何在邻里形状内搜索？
使用按多边形搜索端点，提供一个有序的“经度 纬度”对列表，描绘邻里边界，并进行URL编码。

面积值使用什么单位？
当lotAreaUnit为“sqft”时，lotAreaValue为平方英尺。当存在时，livingArea/area值也以平方英尺为单位。

我在哪里可以查看访问选项和配额？
请查看Zyla API Hub上的API页面以获取当前访问选项和定价。订阅使用配额模型，而不是按调用付费。

准备将实时物业搜索集成到您的应用程序中吗？在此开始您的7天试用并获取您的API密钥：开始7天的实时Zillow数据API试用。在Zyla API Hub目录中使用一个帐户和密钥，快速交付您的房地产功能。