美国租房查询旧版 v2 接口(已弃用)

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

用于梳理旧版租赁房源查询及其迁移要求,不建议用于新项目接入。必填查询参数为 city、state_code、limit 和 offset;可选条件包括价格上下限、最少卧室数与浴室数、房屋面积与地块面积、prop_type、prop_sub_type、allows_cats、allows_dogs、以英文逗号分隔的 features、radius 和 sort。文档给出的示例为 New York City、NY、每次 200 条、偏移量 0,以及 relevance 排序;这些示例并非已确认的服务端默认值。radius 的文档范围为 1–20 英里。位置条件存在需要保留的冲突:文档要求 postal_code 不得与 city、state_code 同时使用,并说明只要 postal_code、city 或 state_code 有值,经纬度边界就不起作用;但此保留契约仍将 city 和 state_code 列为必填。因此,不能宣称仅用邮编或仅用地图边界查询已经得到验证,也不能假定地图边界会进一步限制必填城市和州对应的结果。历史响应文档中的示例片段包含 meta.matching_rows、meta.returned_rows 和 properties 数组;首条记录展示了 listing_id、listing_status、address、beds、building_size、lot_size、community、last_update、list_date 和 photo_count。address 中列有 line、city、state_code、postal_code、lat 和 lon;community 中列有 beds_min、beds_max、baths_min、baths_max、price_min、price_max、sqft_min 和 sqft_max,其中示例中的社区面积上下限均为 null。片段还出现了 photos 字段的开头,但示例已被截断,不能作为完整、可解析的响应。当前没有实测响应,这些历史字段不能证明现有房源可租、宠物政策准确、配套设施信息齐全或响应内容完整。此已弃用接口仅供迁移参考;应逐项清点宠物、房产子类型和设施筛选要求,核实替代接口的契约,不要假定所有旧版条件都能原样迁移。

API 功能

分别保留猫与狗的筛选条件 梳理已保存的租房搜索时,分别保留 allows_cats 和 allows_dogs 两个布尔条件,避免丢失原有的宠物筛选意图。
核对租房配套设施标记 记录 furnished、community_no_fee、laundry_room、community_doorman 等旧版设施标记,并保留以英文逗号分隔的输入方式。
区分房产大类与租赁子类型 映射旧版租房查询前,区分 prop_type 大类与 condo、cond_op、townhouse、co_op 等 prop_sub_type 条件。
明确租房位置条件的优先级冲突 同时记录城市与州必填、邮编不得与城市和州组合,以及具名位置有值时地图边界无效这几项文档限制,避免迁移时误判位置筛选行为。
参考历史社区租赁区间字段 用历史 community 中的卧室数、浴室数、价格和可为空的面积区间检查租房结果界面,但不将截断示例视为经过验证的响应。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-for-rent-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。城市与州被描述为取自位置自动补全的返回值;这些示例不能证明服务端默认值,也不能证明每页最多可请求多少条。

能否用邮编或地图边界代替城市和州?

此保留契约尚未验证这种用法。文档要求 postal_code 不得与城市、州同时使用,并说明只要 postal_code、city 或 state_code 有值,lat_min、lat_max、lng_min 和 lng_max 就不起作用;但 city 和 state_code 又仍然必填。迁移记录中应明确保留这一冲突,不要宣称仅用邮编或地图边界的请求可用。

猫狗政策和租房配套设施如何传入?

allows_cats 和 allows_dogs 是两个独立的可选布尔查询参数,取值为 true 或 false。features 是以英文逗号分隔的字符串,文档标记包括 pets_allowed、furnished、washer_dryer、laundry_room、community_no_fee、community_doorman 和 community_elevator。存在这些筛选参数并不代表当前宠物政策或设施信息已经核实准确。

租房查询中的房产类型和子类型有什么区别?

prop_type 接受以英文逗号分隔的房产大类:single_family、multi_family、condo、mobile、land、farm 和 other。prop_sub_type 接受以英文逗号分隔的 condo、cond_op、townhouse 和 co_op。应保留原始标记并核实替代接口是否支持,不要把两个字段合并。

文档列出了哪些租房排序值和搜索半径范围?

sort 的文档取值为 relevance、newest、price_low、price_high、photos、open_house_date、sqft_high 和 price_reduced_date。relevance 只是示例,并非已确认的默认值。radius 的文档范围为 1–20 英里;它与存在冲突的位置条件同时使用时如何生效,尚未得到验证。

示例能证明当前租房响应的字段结构吗?

不能。目前没有实测响应,历史示例也已被截断。片段展示了 meta 中的数量信息,以及 properties 中的 listing_id、address、listing_status、community 价格、卧室数与浴室数区间,还有可为空的社区面积区间。只能将其作为历史响应参考,不能保证当前仍返回这些字段或对应房源仍可租;此已弃用接口仅应用作迁移参考。

相关接口

相关指南

查看订阅方案 →