搜索出租房源(已弃用)

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

此租房搜索接口已弃用,仅适用于核查现有租房应用,并按筛选条件逐项规划迁移。旧版参数结构将 city、state_code、limit 和 offset 标记为必填。city 和 state_code 应使用地点自动补全返回的值。文档将 postal_code 描述为另一种地点输入方式,且规定不能与 city、state_code 同时使用,但后两项在参数结构中仍为必填,因此仅传邮编的请求尚未验证。文档还说明,只要 postal_code、city 或 state_code 中任一项有值,lat_min、lat_max、lng_min 和 lng_max 四个地图边界参数就不起作用;不能将地图边界描述为可进一步缩小必填城市、州查询范围的有效条件。可选筛选涵盖价格、最少卧室和卫生间数量、房产面积、房产类型、挂牌日期、以英里计的搜索半径、宠物政策标记和社区配套设施。allows_cats、allows_dogs 均不能与 no_pets_allowed 同时使用。prop_type 和 mapi_community_features 支持以逗号分隔文档列出的值。sort 的说明列出 completeness、photos、freshest、price_low、price_high 和 newest,但示例使用 relevance,这一差异尚未解决。现有材料没有实际租房请求的响应,只有截断且未经验证的文档示例。该片段以 listings 数组开头,包含 property_id、listing_id、address、address_new、beds、baths、pet_policy、has_specials、price、price_raw、price_reduced、price_reduced_date、sqft、photo、photo_count、prop_type、prop_status、list_date 和 last_update。片段中的 beds、baths、price 和 sqft 是字符串,price_raw 为数值;address_new 包含 city、state_code、postal_code、lat 和 long。由于示例不完整,无法据此确认完整响应结构、当前字段可用性、数据时效性或请求能否成功。迁移已保存的租房搜索条件前,必须明确核实宠物政策与社区设施筛选是否存在等效支持,不应静默丢弃不受支持的条件。

API 功能

识别租房宠物条件冲突 说明 allows_cats、allows_dogs 与 no_pets_allowed 的互斥关系,避免旧版租房表单同时提交冲突的宠物筛选条件。
保留社区配套设施筛选值 列明 mapi_community_features 使用的 community_washer_dryer、community_parking、central_air、community_pool 和 community_gym,多个值以逗号分隔。
厘清租房地点条件的优先关系 明确城市与州必填、邮编替代说明与必填规则冲突,以及地图边界不生效的条件,避免误以为所有地点参数都能叠加使用。
盘点租房预算与空间约束 围绕 price_min、price_max、beds_min、baths_min、sqft_min 和 sqft_max,梳理现有租房搜索界面的价格、房间数量与面积条件。
提示租房排序示例与说明不一致 保留示例中的 relevance,同时明确旧版说明列出的是 completeness、photos、freshest、price_low、price_high 和 newest,不将两者混为已验证的支持范围。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-for-rent-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、limit=200 和 offset=0;这些只是示例值,并非文档声明的默认值。

邮编或地图边界可以替代必填的城市和州吗?

文档将 postal_code 描述为不能与 city、state_code 同时使用的替代方式,但参数结构仍要求填写 city 和 state_code。文档还说明,只要 postal_code、city 或 state_code 任一项有值,四个坐标边界参数就都不起作用。仅传邮编或仅传地图边界的请求行为尚未验证,不能将这两种方式视为已确认可用的查询模式。

租房宠物筛选标记应如何组合?

不要将 no_pets_allowed 与 allows_cats 或 allows_dogs 同时使用。这些都是可选的布尔类型查询参数。文档没有说明省略标记是否等同于 false,也未验证更细致的宠物政策规则。

租房接口可以请求哪些社区配套设施?

mapi_community_features 在文档中列出 community_washer_dryer、community_parking、central_air、community_pool 和 community_gym,多个值以逗号分隔。使用替代接口时,应检查设施筛选的语法和含义是否等效,而不是假定它支持这些旧版参数值。

relevance 是已经确认支持的租房排序值吗?

relevance 出现在提供的示例中,但 sort 的说明列出的是 completeness、photos、freshest、price_low、price_high 和 newest。目前没有实际请求结果可以消除这一差异;核查旧配置时应保留该示例,但不能声称当前接口已确认接受这个值。

实际观察到了哪些租房响应字段?

没有观察到实际请求响应。不完整的文档片段展示了 listings 及其中的标识、地址、beds、baths、pet_policy、价格、房产状态、面积和照片字段,并将 beds 和 baths 表示为字符串。但完整响应结构以及这些字段当前是否可用,都未经验证。

相关接口

相关指南

查看订阅方案 →