按旧版条件搜索美国待售房源(已弃用)
查看 美国房产与房贷数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 迁移已保存的购房表单前,盘点其对止赎、附条件成交、待完成交易或新建房选项的依赖,再选择替代接口。
- 对照新旧房源搜索能力时,逐项保留原购房条件中的房龄和地块面积上下限。
- 分别核查字符串筛选 reduced=true 与排序 sort=price_reduced_date,避免迁移时用排序替代降价条件。
- 将旧版车库、无障碍、临水、房间和社区设施标记,映射到明确验证过的替代查询语法。
- 根据不完整示例编写待售房源解析测试,覆盖数值型房间数量、展示用价格与面积字符串、数值型 price_raw 及可为空的 sqft_raw。
- 检查现有购房流程是否依赖 is_matterports 筛选 3D 看房房源,而不是假设按照片排序就能保证提供 3D 看房。
常见问题
已弃用的待售房源搜索有哪些必填参数?
参数定义要求填写 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 看房的等效语法及实际行为。没有经过验证的替代方式时,不要默默丢弃原有条件;也不能仅因旧版参数列表列出了其他定位方式,就假设它们能够正常使用。