您从地图点击或移动 GPS 读取中获得了经纬度，现在需要立即获取附近的房产。在本指南结束时，您将使用中心坐标和直径查询真实的地理位置端点，解析响应，并使用来自 Zyla API Hub 的单个 API 密钥进行传输。
您可以通过基于坐标的搜索构建的内容
Zyla API Hub 上的实时 Zillow 数据 API 返回您可以按地理位置过滤的实时房产数据。通过它，您可以：
- 在用户精确位置附近显示列表，用户通过地图点击或 GPS 信号获取位置。
- 通过干净的 API 在您的房地产应用中限制位置感知功能。
- 在需要时将搜索固定到多边形以定义邻里边界或自定义形状。
此 API 返回的数据包括 zpid、地址、纬度/经度、房屋类型、价格、估算等，适用于地理位置用例，例如“这里有什么待售？”
在 Zyla API Hub 上开始
打开 API 页面，订阅并获取您的密钥。Zyla 使用一个帐户、一个 API 密钥和一个订阅 + 配额模型，涵盖超过 10,000 个公共 API。对于此 API，您可以开始 7 天的试用或进行 50 次请求以验证您的集成，然后再进行发布。
您将使用 Authorization: Bearer YOUR_API_KEY 调用端点，没有每次调用的定价惊喜——只需使用您的订阅配额。您可以随时在 Zyla API Hub 浏览更多类别。
您将用于地理位置的端点
以下所有请求使用 Zyla Hub URL 和 Authorization 头中的 Bearer 令牌。
通过坐标搜索
搜索中心经纬度附近的房产，可选择按直径缩小范围。
- 方法：GET
- URL：https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
- 必需参数：
- long（字符串）：经度（例如，-118.504744）
- lat（字符串）：纬度（例如，34.01822）
- 可选参数：
- diameter（字符串）：例如，2
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…您将实际使用响应中的内容：
- data[].zpid：稳定的房产标识符
- data[].latitude，data[].longitude：用于地图绘制
- data[].price 和 currency：与图钉一起显示的定价
- data[].address，city，state，zipcode：标签和上下文
- data[].homeStatus/homeType：UI 中的快速过滤器
- parameters.long/lat/diameter：确认查询的解释方式
搜索
按位置标签（县、邻里、城市或邮政编码）搜索。当用户输入“洛杉矶，加州”或从自动完成中选择城市时，这非常方便。
- 方法：GET
- URL：https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
- 必需参数：
- location（字符串）：例如，洛杉矶，加州
- 可选参数：
- page（字符串）
- home_status（字符串）：例如，FOR_SALE
官方示例：
当您的用户体验从位置文本输入而不是地图点击开始时使用此功能。您仍然可以获得相同的地理位置字段（纬度/经度）以在地图上绘制。
通过多边形搜索
绘制自定义边界——校园、水岸、历史区域——并在其中搜索。当径向距离不足时，这非常理想。
- 方法：GET
- URL：https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
- 必需参数：
- polygon（字符串）：一系列用逗号分隔的“lon lat”对
使用多边形将结果锚定到您的团队或用户关心的确切边界。
最小 Python 示例：通过坐标搜索
此示例调用坐标端点，检查响应，并打印您可以放置在地图上的附近房产。请保持 URL 和参数与所示完全一致。
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/11668/search-by-coordinates"
params = {
"long": "-118.504744",
"lat": "34.01822",
"diameter": "2"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
payload = resp.json()
# 基本的合理性检查
if payload.get("status") != "OK":
raise RuntimeError(f"意外状态：{payload}")
properties = payload.get("data", [])
for p in properties:
print({
"zpid": p.get("zpid"),
"status": p.get("homeStatus"),
"type": p.get("homeType"),
"price": p.get("price"),
"currency": p.get("currency"),
"lat": p.get("latitude"),
"lon": p.get("longitude"),
"address": p.get("address"),
"url": p.get("detailUrl")
})
# 示例：如果可用，则将地图中心设置为第一个列表
if properties:
first = properties[0]
center = (first.get("latitude"), first.get("longitude"))
print("中心建议：", center)节省时间的实施说明
- 身份验证头：Authorization: Bearer YOUR_API_KEY
- 地理输入：将经度、纬度作为字符串传递；直径是可选的。
- 货币和单位：响应包括货币（例如，美元）和适用的面积单位（例如，平方英尺）。使用返回的字段进行显示，而不是硬编码。
- 分页：响应包括一个 parameters.page 字段，显示服务器选择的页面。当您需要额外页面或过滤时，请查阅 API 页面以获取当前选项。
- 缓存：如果您缓存结果，请按查询元组（经度、纬度、直径）进行键入，以避免混合不同区域。
- 错误处理：检查状态 == "OK" 并优雅地处理空数据数组；在日志中显示 request_id 以加快支持速度。
- 配额：此 API 使用订阅 + 配额（而不是按调用计费）。您可以从 7 天的试用或 50 次请求开始，以便快速迭代。有关当前访问选项和定价，请查看 API 页面。
何时使用每种地理位置模式
- 通过坐标搜索：最适合“点击地图并显示附近的内容”。快速、居中的搜索，随着用户的平移而移动。
- 搜索：适合输入的地点，如“94110”或“洛杉矶，加州”。当您还没有确切的坐标时使用此功能。
- 通过多边形搜索：用于邻里级精度。将结果限制在您的产品定义的自定义区域。
通过 MCP 从 AI 代理调用 API
您还可以将这些端点连接到与 MCP 兼容的工具（例如，Claude Code、Cursor、Windsurf）。将您的客户端指向 Zyla MCP 网关并提供您的 API 密钥；您的代理可以调用您上面使用的相同 Hub 列表端点。
文档和端点：MCP
在您的代理工具配置中适用时使用相同的 Authorization: Bearer YOUR_API_KEY 头语义。好处是您可以在 Zyla API Hub 上的数千个 API 中保持单个密钥，同时在 AI 驱动的工作流程中进行开发。
现在实施的端到端流程
- 在 API 页面上开始您的试用并获取您的密钥。
- 使用经度、纬度和可选直径调用通过坐标搜索。
- 在您的地图上呈现 data[].latitude/data[].longitude；在卡片中显示价格、地址和 detailUrl。
- 添加后备：如果用户输入位置，则调用搜索。
- 对于自定义边界，添加绘制多边形模式，调用通过多边形搜索。
常见问题
我如何验证请求？
在每次调用 Hub URL 时发送 Authorization: Bearer YOUR_API_KEY。
直径使用什么参数单位？
该端点接受直径参数作为字符串。有关特定单位语义，请查看 API 页面以获取当前文档。
我可以对坐标搜索进行分页吗？
响应包括一个 parameters.page 字段。有关编程分页支持和可用查询参数，请参考 Zyla 的 API 页面。
是否有免费计划？
访问使用订阅 + 配额，而不是按调用计费。您可以开始 7 天的试用或进行 50 次请求以进行评估；请查看 API 页面以获取当前访问选项和定价。
我可以按房屋状态过滤吗？
搜索端点接受 home_status 作为可选参数。对于地理空间端点，请使用上面显示的文档参数。
准备好发布基于坐标的房产搜索了吗？在这里开始您的试用并获取您的 API 密钥：在实时 Zillow 数据 API 上开始 7 天试用。使用单个密钥构建一次，并在 Zyla 市场中扩展。
