按房产 ID 查询相似房源(已弃用)

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

通过已弃用的旧版接口获取相似房源推荐。三个查询参数均为必填项:property_id 是房源列表结果中的数值型房产标识,prop_status 用于选择 for_sale(出售)或 for_rent(出租),limit 指定希望获取的推荐数量。这些结果仅是推荐候选房源,不是经过核实的已成交可比房产,也不能作为房产估价。 此接口暂无实测响应记录。现有旧版响应示例已截断且未经验证,因此示例字段不代表当前接口保证返回的数据结构。示例中,results.similar_homes.count 表示数量,results.similar_homes.properties 存放推荐房源。房源条目包含 property_id、listing_id、status、list_price、list_date、last_update_date、location、photos 和 primary_photo。description 对象包含 beds、baths、sqft、lot_sqft、type 和 year_built;additional_info 则包含展示文本以及 compared_price_diff、compared_sqft_diff 等比较字段。last_sold_price 等价格字段可能为 null。不能据此推断确切的推荐排序规则、与新版接口相同的覆盖范围,或已经确认的成交价格。替换旧版推荐组件时,应核对标识映射并处理字段缺失情况。

API 功能

以指定房产为参考获取推荐 使用房源列表结果中的数值型 property_id 作为必填参考标识,衔接旧版相似房源推荐流程。
区分出售与出租推荐范围 通过 prop_status 选择 for_sale 或 for_rent,不将相似房源推荐误当成已售可比房产查询。
指定相似房源候选数量 使用必填的 limit 表达希望获取的候选数量;旧版示例将 count 数量字段与 properties 房源数组分开呈现。
梳理旧版推荐卡片比较字段 未经验证的旧版示例在候选房产属性之外,还通过 additional_info 提供展示文本、价格差和建筑面积差等字段。
逐项核对推荐组件迁移差异 替换已弃用接口时,明确比对候选房产标识与可空字段,不假设推荐排序或候选范围保持不变。

在线 API 演示

GET /api/project/realty-in-us/properties-list-similarities-deprecated

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

旧版相似房源查询需要哪些必填参数?

property_id、prop_status 和 limit 均为必填查询参数。此接口将 property_id 定义为数值类型,文档示例为 3109292331。请使用房源列表结果中的房产标识,不要以 listing_id 替代。

可以选择哪些房源状态?

文档列出的 prop_status 值为 for_sale 和 for_rent,分别限定出售与出租推荐范围。此接口没有列出已售状态值。

推荐结果是经过核实的已成交可比房产吗?

不是。这是相似房源推荐接口。compared_price_diff 等示例比较字段不能证明房产已经成交,也不能作为估值结论或符合评估要求的可比房产集合。

示例中的推荐房源位于哪个字段?

未经验证的旧版示例将推荐房源放在 results.similar_homes.properties 中,并在同级设置 count 字段。房源条目示例包含标识、挂牌状态与价格、位置、照片、房屋属性,以及 additional_info 比较值。暂无实测响应可以确认当前的数据结构。

替换接口后会得到相同的推荐房源吗?

目前无法确定。此接口已弃用,且没有成功调用的实测记录。迁移时应比较参考房产标识、状态选择、候选房产、排序和空值处理,不应假设新旧接口的推荐结果相同。

相关接口

相关指南

查看订阅方案 →