您需要通过地址查找物业或绘制地图边界并获取列表——这周，而不是下个季度。在本指南结束时，您将能够通过城市/邮政编码、精确的纬度/经度以及使用 Zyla API Hub 上的实时 Zillow 数据 API 的自定义多边形查询地理定位的物业数据，并提供可复制粘贴的请求和一个最小的 Python 脚本。
您可以使用地理定位优先的物业 API 构建的内容
实时 Zillow 数据 API 提供地理定位的物业搜索，返回关键的列表属性，包括地址、城市、州、邮政编码、纬度、经度、房屋类型、价格（以美元计）、卧室、浴室、居住面积等。您可以：
- 按位置字符串（城市、县、社区或邮政编码）搜索物业。
- 使用纬度/经度和直径（以英里为单位）按地图中心搜索。
- 在自定义多边形内搜索——非常适合在地图上绘制社区或交付走廊。
典型应用包括房地产搜索用户界面、“我附近的房屋”地图、社区分析、关于新 FOR_SALE 列表的警报机器人，以及内部工具中的地址到地理增强——一切都以地理定位为基础。
在 Zyla API Hub 上开始
Zyla API Hub 在一个市场中托管超过 10,000 个公共 API。要使用实时 Zillow 数据 API：
- 打开 API 页面并开始 7 天试用： 开始 7 天试用实时 Zillow 数据 API。
- 订阅（订阅 + 配额；不是按调用付费）。第一个 API：7 天试用或 50 次请求。查看 API 页面以获取当前访问选项和定价。
- 获取您的 API 密钥并使用以下标头发送请求：Authorization: Bearer YOUR_API_KEY。
端点：基于地理定位的搜索
1) 搜索（按地址类似位置）
当您有一个位置字符串（例如城市、县、社区或邮政编码）时使用此方法。
- 方法：GET
- URL： https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- 必需参数：location（例如，“洛杉矶，加州”）
- 可选参数：page（例如，“2”），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"示例响应（截断为官方示例块字段）：
{
"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…您在大多数地理定位流程中实际使用的内容：
- address, city, state, zipcode: 显示准备好的位置字段。
- latitude, longitude: 在地图上标记或计算到 POI 的距离。
- price 和 currency (USD): 在客户端呈现价格、排序或过滤。
- bedrooms, bathrooms, livingArea: 用于卡片和过滤器的快速汇总。
- detailUrl: 在需要时链接到列表页面。
- parameters 中的 page: 用于分页结果。
2) 按坐标搜索（点 + 直径）
当您有一个地图中心并希望在圆形搜索区域内查找房屋时使用此方法。
- 方法：GET
- URL： https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- 必需参数：long, lat
- 可选参数：直径
cURL：
示例响应（官方示例切片）：
3) 按多边形搜索（自定义绘制区域）
使用此方法在地图上绘制的复杂或非标准形状内进行搜索——当简单半径不够精确时非常理想。
- 方法：GET
- URL： https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
- 必需参数：polygon（空格分隔的 lng lat 对，逗号分隔）
cURL：
示例响应（官方示例切片）：
Python 示例：通过地址搜索物业（地理编码的列表数据）
此最小脚本使用“洛杉矶，加州”调用搜索端点并打印关键的地理定位和定价字段。
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
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": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
payload = resp.json()
print("状态:", payload.get("status"))
print("请求 ID:", payload.get("request_id"))
print("API 回显的参数:", payload.get("parameters"))
for item in payload.get("data", []):
print("---")
print("zpid:", item.get("zpid"))
print("地址:", item.get("address"))
print("城市/州/邮政编码:", item.get("city"), item.get("state"), item.get("zipcode"))
print("纬度/经度:", item.get("latitude"), item.get("longitude"))
print("房屋类型:", item.get("homeType"))
print("价格:", item.get("price"), item.get("currency"))
print("卧室/浴室/面积:", item.get("bedrooms"), item.get("bathrooms"), item.get("livingArea"))
print("详细链接:", item.get("detailUrl"))节省时间的实用笔记
- 身份验证：在每个请求中发送 Authorization: Bearer YOUR_API_KEY。
- 分页：page 是一个字符串参数。递增它以分页结果；API 在参数中回显页面值以便追踪。
- 坐标：纬度/经度为十进制度；直接在网络地图上呈现。坐标搜索的距离使用提供的直径参数。
- 货币：返回价格和货币；示例显示美元。不要假设转换——呈现提供的值。
- 过滤：home_status 支持这些示例中的值，如 FOR_SALE。根据返回的字段根据需要应用进一步的客户端过滤。
- 缓存：许多位置查询可以通过 location+page 键进行缓存。当您更改过滤器（如 home_status）或新鲜度很重要时，请清除缓存。
- 图像：imgSrc 可用于可用的缩略图。
您现在可以交付的地理定位优先用例
- “我附近的房屋”小部件：使用用户的地理定位和小直径进行搜索调用。
- 基于城市或邮政编码的着陆页：使用位置设置为城市或邮政编码进行搜索，分页并预渲染带有地址、价格和坐标的卡片。
- 绘制边界搜索：从地图绘制 UI 捕获多边形点，并调用按多边形搜索以获取高精度区域。
- 距离排序或聚类地图：使用纬度/经度计算客户端距离并聚类标记。
- 列表详情增强：存储 zpid、地址和纬度/经度，以便与您自己的数据集进行邻里分析。
通过 MCP 从 AI 代理调用此 API
如果您使用与 MCP 兼容的客户端（例如 Claude Code、Cursor、Windsurf），您可以通过 Zyla 的 MCP 端点路由调用，并保持您的密钥管理集中。请在此处查看 MCP 入口点： MCP。配置您的代理以调用上面显示的实时 Zillow 数据 API 的 HTTPS 端点，并传递您的标准授权标头。这对于像“绘制多边形，然后总结其中前 10 个 FOR_SALE 列表”的代理流程非常有用。
故障排除检查表
- 401 或 403 错误：确认授权标头使用 Bearer YOUR_API_KEY，并且订阅处于活动状态。
- 没有结果：验证位置格式或多边形坐标（lng lat 排序、逗号分隔对、lng 和 lat 之间的空格）。
- 地图偏移：确保您使用的是项目级的纬度和经度字段，而不是城市重心。
- 分页间隙：确保您将页面作为字符串递增，并在页面返回空数据数组时停止。
常见问题解答
API 是否为每个物业返回纬度和经度？
是的。列表包括适合映射和距离计算的纬度和经度字段。
我如何通过精确的地图位置进行搜索？
使用按坐标搜索，提供 long 和 lat（可选直径）以查询靠近某个点的物业。
我可以在用户绘制的自定义形状内搜索吗？
可以。使用按多边形搜索并传递以逗号分隔的 lng lat 坐标对的多边形字符串。
我如何分页处理大型结果集？
将 page 作为参数传递。API 在参数中回显页面，以便您可以跟踪当前位置。
是否有免费计划？
没有免费计划。您可以开始 7 天试用（或您的第一个 API 的 50 次请求）。查看 API 页面以获取当前访问选项和定价。
准备好交付以地理定位驱动的物业搜索了吗？在此处开始您的 7 天试用并获取您的 API 密钥： 开始 7 天试用实时 Zillow 数据 API。然后将上面的端点插入您的地图、后端或代理工作流程并上线。
