旧版 v2 待售住宅搜索(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此接口用于记录旧版购房房源搜索方式,查询参数 city、state_code、limit 和 offset 均为必填。可选条件包括价格上下限、房屋面积上下限、地块面积、最低卧室数与浴室数、房龄上下限、prop_type、prop_sub_type、以逗号分隔的 features、搜索半径 radius 和排序方式 sort。开放看房、附条件成交、止赎、3D 看房、新建住宅、尚未建成住宅及待成交房源分别使用 has_open_house、is_contingent、is_foreclosure、is_matterports、is_new_construction、is_new_plan 和 is_pending 布尔参数筛选。文档规定 radius 的范围为 1 至 20 英里。New York City、NY、limit=200、offset=0 和 relevance 排序均为示例值,不是已确认的默认值。 位置条件存在文档冲突:postal_code 被标注为不能与 city/state_code 同用,但 city 和 state_code 又是必填项;lat_min、lat_max、lng_min、lng_max 四个地图边界参数则被标注为在 postal_code、city 或 state_code 有值时不生效。迁移时应把这些冲突列为待核实问题,不应据此宣称支持仅按邮编、仅按地图边界,或城市与边界叠加搜索。 响应信息仅来自文档,而非实际调用结果:被截断的示例片段展示了 meta.matching_rows、meta.returned_rows 和 properties 数组。可见的房源字段包括 property_id、listing_id、price、beds、baths、baths_full、prop_status、prop_type、prop_sub_type、photo_count、last_update、address 和 mls。address 对象展示了 line、city、state_code、postal_code、lat 和 lon;mls 对象展示了 id、abbreviation、name 和 type。该片段不是可完整解析的响应,目前也没有实测响应可供核对。这些历史字段不能证明当前房源可用性、响应完整性、开放看房安排或看房媒体数据是否存在。 此弃用接口仅供旧版购房搜索迁移参考。替换时应逐项核对开放看房、未建成住宅、新建住宅和房源状态等需求,不能假定当前房源搜索接口接受同样的 GET 查询参数,或具有完全相同的筛选含义。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-v2-list-for-sale-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-for-sale-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
查询结果
使用场景
- 梳理旧版开放看房搜索流程,在替代方案中单独核实看房活动检索能力,不把它等同于普通待售房源查询。
- 迁移购房搜索时,分别保留尚未建成住宅与新建住宅两类检索需求。
- 复核已保存搜索中的附条件成交、待成交和止赎条件,逐项注明是否保留或暂不支持。
- 重建旧版购房候选清单前,记录房龄、临水、无障碍设施、车库及面积等筛选要求。
- 审查仅搜索 3D 看房房源的购房流程,不预设历史响应包含可播放的看房内容或当前仍可使用的看房资源。
常见问题
旧版待售房源搜索有哪些必填参数?
city、state_code、limit 和 offset 均为必填。文档提供的示例值依次为 New York City、NY、200 和 0;这些只是示例输入,不能证明服务端默认值、支持的最大条数或该地区当前的房源情况。
is_new_plan 与 is_new_construction 有什么区别?
文档将 is_new_plan 描述为筛选尚未建成的住宅,将 is_new_construction 描述为仅筛选新建住宅,两者都是可选布尔参数。应保留各自的筛选意图;现有资料既未证明两者等价,也未说明同时使用时的行为。
开放看房和 3D 看房筛选会返回活动日程或可播放的看房内容吗?
目前无法确认。has_open_house 被描述为仅筛选开放看房房源,is_matterports 被描述为仅筛选支持 3D 看房的房源。未经实测且被截断的文档示例不能证明响应包含活动日程、看房链接,也不能证明这些资源目前仍然可用。
哪些标记用于筛选成交状态或止赎房源?
is_contingent、is_pending 和 is_foreclosure 分别被记载为筛选附条件成交、待成交和止赎房源的 true/false 参数。现有资料没有定义它们能否同时使用,也不能保证替代搜索接口都提供对应条件。
邮编或地图边界可以与必填的城市和州同时使用吗?
旧版文档要求 postal_code 不与 city/state_code 同用,并说明四个经纬度边界参数在邮编、城市或州任一条件有值时均不生效,但 city 和 state_code 仍被列为必填。因此,除非另有单独核实的接口约定,否则不能声称仅按邮编、仅按地图边界或城市加边界的查询模式可正常使用。
历史待售房源响应字段能说明什么?
目前只有文档示例可供参考,没有实测响应。截断示例展示了 meta.matching_rows、meta.returned_rows,以及 properties 条目中的 property_id、listing_id、price、卧室和浴室数量、prop_status、address 和 mls。它不能证明当前字段覆盖范围或筛选行为。此弃用接口用于迁移文档,不建议作为新购房搜索集成的起点。