旧版 v2 MLS 房源编号查询(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →使用必填的 mls_id 查询旧版房源记录。可选的 prop_status 用于筛选房源状态,接受 for_sale、for_rent 或 recently_sold;limit 控制请求的条数,offset 指定跳过的条数以实现分页。比对记录时应保留 MLS 来源和房源状态信息,现有文档并未证明 MLS 编号在所有来源中全局唯一。 以下响应说明来自文档示例,并非实测输出:留存示例包含 meta.matching_rows、meta.returned_rows 以及 properties 数组。示例中的房产字段包括 property_id、listing_id、price、beds、baths、baths_full、prop_status、prop_type、prop_sub_type、photo_count 和 last_update。address 对象包含 line、city、state、state_code、postal_code、lat 和 lon;mls 对象包含 id、abbreviation、name 和 type。这些字段均来自未经验证的示例,此接口没有实测响应记录,无法确认这些字段当前是否返回、是否完整或接口是否可用。 此接口已弃用,保留说明仅用于梳理旧版按 MLS 编号查询的流程及其迁移要求。不建议新项目以此作为接入入口,也不能将其视为完整的 MLS 数据源。不要假定当前的通用房产搜索接受相同的 MLS 编号查询参数。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-v2-list-by-mls-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-by-mls-deprecated?key=<API_KEY>&mls_id=<mls_id>'
查询结果
使用场景
- 替换旧版按 MLS 编号查询的接口前,盘点现有流程并记录必填的 mls_id。
- 将旧版 MLS 查询结果与迁移后的记录进行比对时,保留 for_sale、for_rent 或 recently_sold 的状态信息。
- 记录旧版 MLS 查询如何使用 limit 和 offset 分页,避免替代流程在未提示的情况下只检查首页。
- 依据单独验证过的替代接口约定,比对历史 MLS 来源、房产标识和地址,不预设新接口同样支持 MLS 编号查询。
常见问题
旧版 MLS 查询必须提供哪个参数?
此接口约定中唯一必填的查询参数是 mls_id,文档示例为 OLRS-1293107。limit、offset 和 prop_status 均为可选参数。应保留 MLS 编号所属的来源信息,不要将其视为已证实全局唯一的房产标识。
prop_status 可以筛选哪些房源状态?
文档列出的值为 for_sale(在售)、for_rent(出租)和 recently_sold(近期售出)。整理现有查询时,应原样保留参数值,包括下划线。现有资料未验证这些状态当前能否匹配到房源。
按 MLS 编号查询时如何分页?
limit 指定请求的条数,offset 指定跳过的条数。文档示例分别为 10 和 0。这只是示例值,不能据此确认服务端默认值或最大限制。
MLS 查询的响应字段经过实测验证吗?
没有。未经验证的示例展示了 meta.matching_rows、meta.returned_rows,以及含 property_id、listing_id、mls、address、price 和房源状态字段的 properties 条目。没有实测响应能够确认这些字段当前是否可用或完整。
可以直接用新的房产搜索替换这个 MLS 接口吗?
目前无法确认两者等价。此接口已弃用,保留说明仅供迁移参考。应验证替代接口是否接受 MLS 编号,以及能否保留原流程的来源、状态和分页意图,不要将原查询参数直接复制到其他接口。