搜索出租房源(已弃用)
查看 美国房产与房贷数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 检查现有可养宠物租房页面,找出 no_pets_allowed 与 allows_cats、allows_dogs 同时提交的冲突组合。
- 为租房搜索迁移制定逐项清单,分别验证停车位、洗衣设备、泳池、健身房和空调等社区设施条件。
- 向维护人员说明:按文档约定,已传入 city 和 state_code 的租房搜索不会再受地图矩形边界限制。
- 依据不完整的租房示例构造解析测试,覆盖字符串类型的卧室和卫生间数量、文本 pet_policy,以及格式化价格与数值价格字段。
- 审查已保存的 sort=relevance 租房搜索配置,不因示例出现该值就认定当前接口已确认支持。
常见问题
已弃用的租房接口将哪些参数标记为必填?
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 表示为字符串。但完整响应结构以及这些字段当前是否可用,都未经验证。