根据邮政编码和房产 ID 查找相似出租房(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此旧版接口用于查找与指定参考房产相似的出租房。postal_code 和 property_id 均为必填的字符串查询参数:postal_code 应取自房源列表响应,property_id 应取自房产列表响应。仅提供邮政编码不构成完整请求,现有文档也未说明可配置搜索半径。 该接口已明确弃用。弃用说明指向 /properties/v2/list... 系列接口,但未确认其中存在功能等同的出租房推荐接口。目前没有该接口的实测响应或文档响应示例,因此响应外层结构、出租状态字段、租金报价字段、排序方式以及空结果格式均未验证。推荐的出租候选房源不代表已完成的租赁交易,也不能用于证明实际成交租金。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-v2-list-similar-rental-homes-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-similar-rental-homes-deprecated?key=<API_KEY>&postal_code=<postal_code>&property_id=<property_id>'
查询结果
使用场景
- 在停用旧版请求前,审查相似出租房推荐面板是否同时保存 postal_code 和 property_id。
- 检查出租参考房源记录是否保留邮政编码与房产标识的配对,避免构造仅含邮政编码的请求。
- 评估另行验证的替代接口时,复核现有租房对比页面判断出租状态的方式。
- 在迁移方案中将推荐出租房源与实际成交租赁数据分开,不预设此接口提供任何一类租金金额。
常见问题
旧版相似出租房查询需要哪些参数?
postal_code 和 property_id 都是必填的字符串查询参数。只提交其中一个,不符合文档规定的请求要求。
邮政编码和房产 ID 应从哪里获取?
文档要求 postal_code 取自房源列表结果,property_id 取自房产列表响应,包括文档所述的 /properties/list-... 或 /properties/v2/list-... 搜索接口。请保留返回的标识字符串,不要转换为数字。
postal_code 能保证推荐房源位于指定范围内吗?
不能据此保证。现有文档仅将 postal_code 列为必填参数,未说明推荐范围、距离规则或排序逻辑,也没有提供半径参数,因此不应预设其地理范围行为。
此接口返回已完成的租赁交易或实际成交租金吗?
文档所述用途是列出相似的待租房源,而非已完成的租赁交易。目前没有实测响应或文档示例可用于核实该接口的出租状态、租金报价或实际成交租金字段。
可以直接用相似待售房查询替代此接口吗?
不要假定两者等同。该接口已弃用,弃用说明提及 /properties/v2/list... 系列接口,但仍需单独核对替代接口是否返回出租候选房源,以及其输入要求和响应是否兼容。