按地图矩形边界搜索房源
查看 Zillow 美国房产与市场数据 API 的全部接口 →用十进制度数填写 north、south、east、west 四条边界。虽然模式分别将字段标为可选，要表达明确的矩形范围仍需四者齐全；此接口不是中心经纬度加半径查询。zoom 默认 13，可叠加状态、价格、卧室、卫浴、房型、设施和可负担性筛选，并用 page 或 cursor 续查。 文档描述为返回指定边界内的房源搜索集合，result_type 选择 list 或 map。此路由没有已保存的实测响应，精确集合字段、筛选执行及续查行为均未验证。导入前先检查业务结果和资源身份；相邻或重叠范围可在客户端按实际返回的房产 ID 去重，不能把范围内的结果当成全部住房清单。
API 功能
四条边定义范围 用南北纬度与东西经度定义矩形，不添加未公开的距离参数。
保留地图缩放背景 zoom 默认 13，可与地图界面使用的边界一起提交。
范围内按条件筛选 在所选区域按待售、待租、已售及价格、面积、建造年份、设施等字段缩小候选。
客户端合并重叠区域 可用返回的房产标识合并相邻或重叠范围；接口本身不保证跨区域去重。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/zillow-real-estate/search-by-coordinates API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/zillow-real-estate/search-by-coordinates?key=<API_KEY>&zoom=13&status=for_sale&page=1&page_size=40&result_type=list&sort=relevance'
curl -X GET 'https://api.opendata-api.com/api/project/zillow-real-estate/search-by-coordinates?key=<API_KEY>&zoom=13&status=for_sale&page=1&page_size=40&result_type=list&sort=relevance'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 手动地图搜索：用户明确选择搜索当前区域后，再查询可见矩形内的房源。
- 服务区域库存研究：对多组矩形范围使用一致的房源筛选条件。
- 邻接区域比较：先保存每个矩形及其结果，再对重叠房产去重。
- 地图筛选原型：评估选定状态与房型下的房源密度，不替换成未支持的半径参数。
常见问题
能否传中心坐标和半径？
没有定义半径参数。请传 north、south、east、west，必要时加 zoom，不能将文档中的矩形改为直径或半径请求。
字段是可选的，为什么还要填全四条边？
模式没有表达四者的联合要求，但只有四条边才能说明目标矩形。缺少部分边界时的行为未实测。
地图搜索接口已经实测了吗？
此接口没有已保存的实测响应。输入与预期用途依据文档，生产使用前应核对实际结构和筛选效果。