按房产 ID 查询相似待售住宅(已弃用)

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

此旧版接口用于查询与指定参考房产相似的待售住宅。必填查询参数 property_id 为字符串,应使用房源列表响应中返回的 property_id。该接口已明确弃用,仅用于梳理或迁移现有的待售房源推荐流程。弃用说明指向 /properties/v2/list... 系列接口,但未确认其中存在等价替代接口,也未确认推荐排序保持一致。 目前没有此操作的实测响应或文档响应示例。因此,响应结构、结果字段名、推荐条数、排列顺序以及当前可用性均未经核实。

API 功能

以参考房产查找相似待售住宅 文档记载的用途是查找与指定房产相似的待售住宅,而不是按地址或城市进行普通房源搜索。
仅需一个 property_id 查询参数 请求要求传入从房源列表响应中取得的字符串 property_id;该接口未记载价格、卧室数量或搜索半径等筛选参数。
识别需要迁移的待售推荐模块 利用明确的弃用标记排查现有待售房推荐模块,制定迁移计划,而不是在新功能中继续依赖此接口。
明确替代推荐排序尚未核实 弃用说明仅提及 /properties/v2/list... 系列接口,未确认替代方案的排序、结果条数或响应字段兼容性。

在线 API 演示

GET /api/project/realty-in-us/properties-v2-list-similar-homes-deprecated

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-similar-homes-deprecated?key=<API_KEY>&property_id=<property_id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个已弃用的接口查询什么?

文档记载的用途是列出与参考房产相似的待售住宅。它不是通用城市房源搜索,也不同于另一个相似出租房源查询接口。

property_id 应从哪里获取?

使用房源列表响应中的 property_id 字段,例如文档列出的 /properties/list-... 或 /properties/v2/list-... 搜索响应。应将其作为字符串传入。示例标识仅用于说明,不能保证当前仍有可用匹配。

能按价格或距离筛选相似待售住宅吗?

此接口未记载这类输入参数。唯一记载的参数是必填的 property_id,因此不能假定支持售价、卧室数或搜索半径筛选。

哪些响应字段和排序方式经过验证?

此操作尚无经过验证的响应字段或排序方式:现有资料中没有实测响应,也没有文档响应示例。响应结构、房产字段、结果数量、顺序及空结果格式均未核实。

是否有已经确认可直接替换的接口?

没有。弃用说明指向 /properties/v2/list... 系列接口,但未确认具体的等价请求与响应约定,也未确认排序一致。替换现有推荐模块前,应单独评估合适的当前接口。

相关接口

相关指南

查看订阅方案 →