旧版 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 功能

区分开放看房与 3D 看房筛选 分别核对 has_open_house 与 is_matterports 的需求;文档记载了筛选用途,并不代表响应一定包含活动详情或可播放的看房媒体。
保留未建成住宅与新建房的差异 评估替代接口时,将表示尚未建成住宅的 is_new_plan 与 is_new_construction 新建住宅标记分开处理。
逐项复核成交与止赎状态 分别梳理 is_contingent、is_pending 和 is_foreclosure,避免迁移时把不同状态的购房搜索全部合并为普通待售查询。
拆分购房所需的房屋属性条件 将 age_min、age_max、最低卧室及浴室数、房屋面积与地块面积上下限分别记录为购房搜索要求。
以旧版查询清单核对替代请求 利用文档中的 GET 参数整理筛选清单,并另行确认替代接口的请求结构,而不是直接复制旧版查询。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

旧版待售房源搜索有哪些必填参数?

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。它不能证明当前字段覆盖范围或筛选行为。此弃用接口用于迁移文档,不建议作为新购房搜索集成的起点。

相关接口

相关指南

查看订阅方案 →