美国在售房源 API - Realtor 按城市和邮编查询挂牌房产

传入美国城市、邮编、地址，或 property-auto-complete 返回的地点 ID，发现挂牌出售的房源。New York, NY 搭配 sort=newest 已实测。成功结果包含 status=true、message、扁平 data 数组，以及 resultsPerPage、totalResultCount、totalPages、currentPage。已观察到 property_id、listing_id、status=for_sale、list_price、list_date、location.address、description 中的卧室/浴室/面积，以及 primary_photo.href 和 photos[].href；部分属性可能为 null。价格、房间数、面积、房产类型与设施条件属于已列出的可选参数，尚未逐项验证筛选效果。pageSize=8 实际返回 30 条，应按数组长度处理并检查翻页，不要假设请求条数和汇总页数完全可靠。不存在的城市曾返回 HTTP 200、status=false、data=null，并附含糊的分页错误；不能仅凭 HTTP 200 判定搜索成功。

API 功能

实测纽约在售样本 纽约查询返回 for_sale 房源及 property_id、listing_id，可用于后续详情关联。

以挂牌售价展示房源卡片 组合可用的 list_price、地址、卧室、浴室和主图；缺失属性继续保留 null。

买房筛选条件参考 可提交价格、建筑面积、地块、房产类型与设施参数，投入使用前需验证实际筛选行为。

识别无匹配的业务失败 读取 status 与 message；HTTP 200 下的分页错误不应被误渲染成成功房源列表。

在线 API 演示

GET /api/project/realtor/property-search-buy

城市、邮编、地址或地点 ID *

房源排序（选填）

最低挂牌价（选填）

最高挂牌价（选填）

最少卧室数（选填）

最多卧室数（选填）

最少浴室数（选填）

最多浴室数（选填）

房产类型（选填）

页码（选填）

请求每页条数（选填）

仅新建房源（选填）

最大建筑面积（平方英尺）（选填）

地块特征（选填）

每月 HOA 费用上限（选填）

仅带虚拟看房（选填）

车库停车筛选（选填）

隐藏 55 岁以上社区（选填）

纽约市配套条件（选填）

房屋设施（选填）

社区设施（选填）

仅止赎房源（选填）

最大地块面积（平方英尺）（选填）

供暖与制冷设施（选填）

扩大搜索区域（选填）

隐藏尚未建成房屋（选填）

在 Realtor 挂牌天数（选填）

带 3D 看房（选填）

最大房龄（选填）

显示 HOA 信息未知的房源（选填）

仅开放看房房源（选填）

隐藏待成交或附条件成交房源（选填）

最小地块面积（平方英尺）（选填）

仅近期降价房源（选填）

最小建筑面积（平方英尺）（选填）

最小房龄（选填）

API 响应 (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-buy?key=<API_KEY>&location=New+York%2C+NY&sort=newest&page=1&newConstructionOnly=false&virtualToursOnly=false&garageParking=false&hide55plusCommunity=false&foreclosuresOnly=false&hideHomesNotYetBuilt=false&has3dTours=false&showHomesWhereHoaIsNotKnown=false&openHousesOnly=false&hidePendingContingent=true&priceRecentlyReducedOnly=false'

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-buy?key=<API_KEY>&location=New+York%2C+NY&sort=newest&page=1&newConstructionOnly=false&virtualToursOnly=false&garageParking=false&hide55plusCommunity=false&foreclosuresOnly=false&hideHomesNotYetBuilt=false&has3dTours=false&showHomesWhereHoaIsNotKnown=false&openHousesOnly=false&hidePendingContingent=true&priceRecentlyReducedOnly=false'

📢

需要帮助？

如遇接口异常，或需要其他接口需求，可联系我们

联系我们

使用场景

为购房网站搭建按城市浏览的入口，展示可用挂牌价与房源图片。
以 property_id、listing_id 和采集时间保存周期性挂牌库存样本。
由人工筛选待尽调的购房候选，再按需查询详细信息。
把筛选条件与返回属性逐项对照，验证后再开放生产环境购房搜索表单。

常见问题

可以用美国邮编代替城市名搜索在售房源吗？

location 的文档输入包括城市、ZIP Code、地址和地点补全返回的 ID。已实测示例为 New York, NY；接入其他地区时仍应核对返回地址与预期范围。

为什么设置 pageSize=8 却拿到 30 条房源？

已观察到该参数未按请求值限制条数。请读取实际 data 数组长度，检查相邻页面并去重，不要把 pageSize 当成严格响应上限。

HTTP 200 就代表查到在售房源了吗？

不是。无匹配城市曾返回 status=false、data=null 和含糊的分页错误。还需检查平台 code/message/data 以及数据中的搜索业务状态。

使用指南

查看订阅方案 →

按城市或邮编查询美国在售房源