按房产 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 参数。
- 整理旧版推荐功能文档时,分别说明出售房源推荐面板和出租房源推荐面板的参数用途。
- 将已保存的推荐房产标识与替代接口的结果进行比较,不预设两者排序或覆盖范围一致。
- 使用缺失照片、历史价格为 null 及旧版 additional_info 展示字段等情况,测试推荐卡片的数据适配。
常见问题
旧版相似房源查询需要哪些必填参数?
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 比较值。暂无实测响应可以确认当前的数据结构。
替换接口后会得到相同的推荐房源吗?
目前无法确定。此接口已弃用,且没有成功调用的实测记录。迁移时应比较参考房产标识、状态选择、候选房产、排序和空值处理,不应假设新旧接口的推荐结果相同。