根据指定房产查找相似住宅

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

通过 GET /properties/v3/list-similar-homes 请求相似住宅候选房源。必填查询参数 property_id 应取自房源列表结果中的 property_id 字段,不能使用 listing_id。可选查询参数 status 为单个字符串,文档列出的取值包括 for_sale、ready_to_build、for_rent、sold、off_market、other 和 new_community。可选数值参数 limit 用于控制每次响应的条目数量;10 只是文档示例,并非已验证的默认值或上限。本接口仅提供 limit 来控制返回数量,没有文档说明支持 offset、页码或游标参数。 现有证据没有成功调用的响应,也没有响应示例,因此响应外层结构、候选房源字段、实际返回数量、相似性标准、排序方式和地理范围均未验证。应将返回的住宅展示为备选建议,并在比较前核对其位置、房源状态和住宅属性,不应将本接口作为可比成交案例估价或房产估值依据。

API 功能

以选中房产发起相似住宅查询 直接使用已选搜索结果的 property_id 请求相似住宅,无需重新拼接地址或社区筛选条件。
支持文档列出的七种候选状态 可选择 for_sale、ready_to_build、for_rent、sold、off_market、other 或 new_community 中的一个状态字符串;这些取值尚未经成功响应验证。
为关联房源模块设置数量限制 通过可选数值参数 limit 限制请求的候选数量。文档示例为 10,但默认值、上限以及是否一定返回足量结果均未验证。
区分备选房源建议与估价依据 将结果视为候选住宅,而非已经核实的可比房产。响应结构、相似度分数、排序方法和搜索半径均尚未确定。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

如何指定相似房源查询的参考住宅?

将房源列表结果中的 property_id 作为必填的 property_id 查询字符串传入。文档未说明可以使用 listing_id 或街道地址代替该标识。

相似房源查询的 status 有哪些文档列出的取值?

可选的 status 字符串可取 for_sale、ready_to_build、for_rent、sold、off_market、other 或 new_community 中的一个值,示例为 for_sale。这些是文档列出的取值,并非已成功测试的组合;文档未说明支持数组或逗号分隔的多状态写法。

limit 为 10 是否保证返回十套住宅,或表示默认值?

都不是。10 只是可选数值参数 limit 的示例值。现有证据未验证默认值、上限或保证返回的候选数量,本接口也没有文档说明支持 offset、页码或游标请求参数。

响应会返回哪些字段和相似度分数?

现有资料未提供成功调用的响应或响应示例,因此候选字段、响应外层结构、相似度分数、排序和地理范围均未验证。设计固定的推荐卡片字段结构前,应先验证实际响应。

相似已售住宅能否直接用作经过核实的估价依据?

不能。可以使用文档列出的 sold 状态请求候选建议,但相似性标准和可比性尚未确定。比较价格前,应分别核对地理位置、成交状态、住宅属性及相关日期。

相关接口

相关指南

查看订阅方案 →