查找所选房产的相似房源候选
查看全部 Realtor 美国房产数据 API →传入搜索结果中的 propertyId，可选 pageSize。文档用途是发现相似房源，但本接口尚未实测；返回字段、相似判定标准和请求条数的效果都未确认。向用户展示替代房产前，应独立核对候选身份、地区、状态与属性。不要把未知匹配方法宣传为个性化智能推荐、估值建议或可用于正式估价的已售可比样本。
API 功能
以所选房产作为查找起点 propertyId 指向一个已发现的房产，作为文档中的相似房源查询输入。
相似候选条数请求 可评估 pageSize，但尚未确认它如何影响实际返回数量。
逐条检查替代房源属性 根据真实返回的地址、状态和属性评价候选，而不是只相信“相似”名称。
不夸大未知相似算法 匹配标准与响应未验证，不能视为个性化推荐或估价结果。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/property-similar-homes API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-similar-homes?key=<API_KEY>&propertyId=<propertyId>'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-similar-homes?key=<API_KEY>&propertyId=<propertyId>'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为正在浏览单套房产的用户评估替代房源展示区。
- 从相关房产候选中整理人工并排比较的研究清单。
- 比较多个目标房产的候选重合程度，判断上线前的实用性。
- 审核相似结果是否满足产品预期的地区与市场状态。
常见问题
“相似”具体按价格、面积还是位置匹配？
尚未确认。文档未建立已验证的相似判定方法，应检查实际候选属性，不能宣传固定匹配逻辑或个性化能力。
pageSize=12 能保证返回 12 套替代房源吗？
不能。本接口未实测，请以实际数组长度为准，并验证参数对数量的影响。
相似房源可以直接作为正式估价的可比案例吗？
不可以直接认定。需独立核对市场状态、地理位置、成交信息和可比性，本接口不提供认证估价或专业可比案例保证。