按房产 ID 查询相似待售住宅(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →此旧版接口用于查询与指定参考房产相似的待售住宅。必填查询参数 property_id 为字符串,应使用房源列表响应中返回的 property_id。该接口已明确弃用,仅用于梳理或迁移现有的待售房源推荐流程。弃用说明指向 /properties/v2/list... 系列接口,但未确认其中存在等价替代接口,也未确认推荐排序保持一致。 目前没有此操作的实测响应或文档响应示例。因此,响应结构、结果字段名、推荐条数、排列顺序以及当前可用性均未经核实。
API 功能
以参考房产查找相似待售住宅 文档记载的用途是查找与指定房产相似的待售住宅,而不是按地址或城市进行普通房源搜索。
仅需一个 property_id 查询参数 请求要求传入从房源列表响应中取得的字符串 property_id;该接口未记载价格、卧室数量或搜索半径等筛选参数。
识别需要迁移的待售推荐模块 利用明确的弃用标记排查现有待售房推荐模块,制定迁移计划,而不是在新功能中继续依赖此接口。
明确替代推荐排序尚未核实 弃用说明仅提及 /properties/v2/list... 系列接口,未确认替代方案的排序、结果条数或响应字段兼容性。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
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>'
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 来自哪一次房源列表响应。
- 单独验证当前替代方案后,再建立迁移核对清单,比较候选待售房产标识、排序和空结果行为。
- 在开发文档中将此相似待售房查询标记为仅供旧版维护,同时保留其请求参数说明。
常见问题
这个已弃用的接口查询什么?
文档记载的用途是列出与参考房产相似的待售住宅。它不是通用城市房源搜索,也不同于另一个相似出租房源查询接口。
property_id 应从哪里获取?
使用房源列表响应中的 property_id 字段,例如文档列出的 /properties/list-... 或 /properties/v2/list-... 搜索响应。应将其作为字符串传入。示例标识仅用于说明,不能保证当前仍有可用匹配。
能按价格或距离筛选相似待售住宅吗?
此接口未记载这类输入参数。唯一记载的参数是必填的 property_id,因此不能假定支持售价、卧室数或搜索半径筛选。
哪些响应字段和排序方式经过验证?
此操作尚无经过验证的响应字段或排序方式:现有资料中没有实测响应,也没有文档响应示例。响应结构、房产字段、结果数量、顺序及空结果格式均未核实。
是否有已经确认可直接替换的接口?
没有。弃用说明指向 /properties/v2/list... 系列接口,但未确认具体的等价请求与响应约定,也未确认排序一致。替换现有推荐模块前,应单独评估合适的当前接口。