MLS 挂牌编号查询 API - Realtor 公开房源关联

将已知 MLS 挂牌编号作为 mlsId，page 与 pageSize 是可选数字参数。示例是挂牌编号，不是城市名称。本接口尚未实测，返回房源字段、编号歧义和分页行为未确认。关联记录前应核对实际返回的房产身份与地区。按 MLS 编号查找公开房源不代表直接接入 MLS，不提供 IDX 授权、完整 MLS 覆盖或房源转载许可。

API 功能

以 MLS 编号发起查询 mlsId 填写挂牌参考编号，不应替换为城市名或 property_id。

公开挂牌编号关联范围 返回内容需先核对身份，再与已有记录建立关联。

编号查询的可选翻页 保留数字 page 和 pageSize 用于测试，但不保证已验证的分页结果。

编号查询不等于 MLS 授权 公开参考编号查找与获授权 MLS/IDX 数据源、转载权是不同事项。

在线 API 演示

GET /api/project/realtor/property-search-mls-id

API 响应 (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-mls-id?key=<API_KEY>&mlsId=<mlsId>'

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-mls-id?key=<API_KEY>&mlsId=<mlsId>'

📢

需要帮助？

如遇接口异常，或需要其他接口需求，可联系我们

联系我们

使用场景

在房产笔记中解析用户提供的挂牌参考编号，并人工检查当地编号歧义。
将经纪业务提供的 MLS 编号与返回的公开房产身份进行核对。
调查不同地区重复编号的情况，避免自动接受错误匹配。
为尚不掌握 property_id 的分析人员评估编号输入入口。

常见问题

mlsId 与 property_id 可以互换吗？

不可以。mlsId 是已知 MLS 挂牌参考编号，property_id 是房产标识。应使用对应输入，并核对返回地址和房产身份。

一个 MLS 编号能保证唯一匹配某套房吗？

不能保证。本接口的编号歧义和返回行为未实测，关联记录前需检查地区与实际房产身份，不宜仅凭编号自动匹配。

能查到 MLS 编号是否就获得 MLS/IDX 使用权？

不是。公开编号查询不授予 MLS 数据访问、IDX 许可或图片文字转载权；实际使用权限需另行确认。

使用指南

查看订阅方案 →

通过 MLS 挂牌编号查找公开房源