根据指定房产查找相似住宅
查看 美国房产与房贷数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 并明确设置 for_sale 状态。
- 使用文档列出的 for_rent 状态提供相似出租房源入口,并根据实际返回的候选房源验证状态筛选是否生效。
- 通过 sold 状态探索相似已售住宅候选,在人工比较价格前核对位置和住宅属性。
- 显式设置 limit,让房产详情页的推荐模块保持精简,不自行添加未经文档说明的 offset 或游标分页控件。
- 允许用户将关联房源查询切换到 ready_to_build 或 new_community,并明确标注结果仅为建议,不保证具有可比性。
常见问题
如何指定相似房源查询的参考住宅?
将房源列表结果中的 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 状态请求候选建议,但相似性标准和可比性尚未确定。比较价格前,应分别核对地理位置、成交状态、住宅属性及相关日期。