按旧版条件搜索美国待售房源(已弃用)

查看 美国房产与房贷数据 API 的全部接口 →

此待售房源搜索接口已弃用,仅适合维护旧版购房搜索表单,以及核对已保存搜索条件的迁移情况,不建议用于新接入。旧版参数定义要求填写 city、state_code、limit 和 offset,其中 city 与 state_code 应使用地点自动补全返回的值。文档同时将 postal_code 列为城市与州的替代定位方式,且要求两者不得同时使用,但这与 city、state_code 的必填定义存在冲突;仅凭邮编搜索的行为尚未验证。四个范围坐标参数 lat_min、lat_max、lng_min、lng_max 在 postal_code、city 或 state_code 任一有值时均被描述为无效,因此不能将它们视为必填城市与州搜索之上的有效范围限制。 可选购房条件包括价格、卧室数、浴室数、房龄、房屋面积、地块面积、挂牌日期、以英里计的搜索半径,以及用逗号分隔的房产类型和设施特征。is_contingent、is_foreclosure、is_matterports、is_new_construction、is_pending 为布尔参数,分别涉及附条件成交、止赎、3D 看房、新建房和待完成交易房源。reduced 则保留为字符串参数,文档值为 true 或 false,不能与上述布尔参数混为一谈。排序值包括 relevance、price_low、price_high、photos、newest、open_house_date、sqft_high 和 price_reduced_date。 现有材料未提供实际调用得到的待售搜索响应。唯一的文档示例不完整且未经验证,以 listings 数组开头,包含 property_id、listing_id、address、address_new、beds、baths、baths_full、price、price_raw、sqft、sqft_raw、prop_type、prop_sub_type、prop_status、is_new_construction、is_new_listing、photo_count、list_date、last_update,以及含 id、name、abbreviation 的 mls 对象。片段中,beds 与 baths 为数值,price 与 sqft 为展示字符串,price_raw 为数值,sqft_raw 为 null;address_new 包含 city、state_code、postal_code、lat 和 lon。该片段无法证实完整响应结构、结果总数、当前字段可用性或请求能否成功。迁移前应逐项核实购房状态和设施条件,尤其是止赎、待完成交易和降价筛选;不得默默丢弃没有已验证替代方式的条件。

API 功能

分别核对购房交易状态开关 保留 is_contingent、is_foreclosure、is_pending、is_new_construction 四个独立布尔输入,避免将附条件成交、止赎、待完成交易和新建房等不同需求合并处理。
区分降价字符串筛选与降价时间排序 reduced 使用字符串形式的 true 或 false;price_reduced_date 仅是另一项排序值,不能将其当作降价筛选本身。
保留房龄与地块面积的上下限 分别记录 age_min、age_max、lot_sqft_min、lot_sqft_max,避免迁移时将已保存的购房条件简化为价格和卧室数。
梳理逗号分隔的住宅与社区设施标记 保留 features 中关于房间、停车位、无障碍设施、景观、户外配套及社区设施的旧版取值,但不宣称这些取值已有经过验证的现行替代方式。
识别开放看房日期与面积排序选项 除价格和新近程度排序外,还列出 open_house_date、sqft_high;按开放看房日期排序并不等于只筛选有开放看房安排的房源。
单独保留 3D 看房房源选择器 保留文档中用于仅查找带 3D 看房房源的布尔参数 is_matterports,并与照片排序和新建房状态分别处理。

在线 API 演示

GET /api/project/realty-in-us/properties-list-for-sale-deprecated

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-for-sale-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

已弃用的待售房源搜索有哪些必填参数?

参数定义要求填写 city、state_code、limit 和 offset。文档说明 city 与 state_code 使用地点自动补全返回的值。所给示例分别是 New York City、NY、200 和 0,但这些都不是文档明确规定的默认值。

待售搜索能同时使用城市、州、邮编和矩形范围坐标吗?

文档将 postal_code 描述为 city 与 state_code 的替代方式,要求不得同时使用,尽管参数定义又将 city 和 state_code 都列为必填。文档还说明,只要 city、state_code 或 postal_code 中任一有值,范围坐标就不生效。仅使用邮编或仅使用范围坐标的请求都未经验证。

房源状态开关与 reduced 有什么类型区别?

is_contingent、is_foreclosure、is_pending、is_new_construction 和 is_matterports 都是布尔参数;reduced 则是字符串参数,文档取值为文本 true 或 false。应保留这些类型差异,并验证多个开关组合使用时的行为,不能假设各状态筛选可以随意组合。

按 price_reduced_date 排序就只会返回降价房源吗?

目前无法确认。price_reduced_date 是排序值,reduced 才是独立的降价筛选参数。同样,open_house_date 表示排序方式,文档并未将其定义为只保留有开放看房安排房源的布尔筛选。

待售房产类型和住宅设施条件应如何填写?

使用文档列出的取值,多个值以逗号分隔。prop_type 支持 single_family、condo、mobile、multi_family、farm 和 land。features 使用单独的旧版取值列表,例如 basement、garage_2_or_more、disability_features、waterfront 和 community_park。现有材料未说明多个值之间的匹配规则。

待售搜索的响应字段和结果总数经过验证了吗?

没有提供实际调用响应。不完整的文档示例展示了 listings,以及部分标识、地址、价格、房间数量、面积、状态和 MLS 字段。其中 beds 与 baths 为数值,price 与 sqft 为字符串,price_raw 为数值,sqft_raw 为 null,但这不能证实当前字段类型,也不能确定包含结果总数的完整响应结构。

迁移已保存的购房搜索时,哪些条件需要特别核查?

应核实止赎、待完成交易、附条件成交、降价、房龄、地块面积、设施特征和 3D 看房的等效语法及实际行为。没有经过验证的替代方式时,不要默默丢弃原有条件;也不能仅因旧版参数列表列出了其他定位方式,就假设它们能够正常使用。

相关接口

相关指南

查看订阅方案 →