旧版 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 功能

梳理按 MLS 编号查询的旧入口 盘点旧系统接入方式时,将必填 mls_id 的查询流程与地址搜索、通用房产搜索分别记录。
结合挂牌状态核对 MLS 匹配 记录可选的 for_sale、for_rent 和 recently_sold 筛选值,不将房源状态与 MLS 编号本身混为一谈。
保留 MLS 结果的偏移分页逻辑 保留可选的 limit 和 offset 控制项,使迁移后的流程仍能核对每页条数及跳过的结果数量。
按 MLS 来源比对历史房源记录 将历史示例中的 mls、property_id 和 listing_id 字段列入迁移核对清单,但不据此认定记录唯一或当前仍可获取。

在线 API 演示

GET /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,文档示例为 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 编号,以及能否保留原流程的来源、状态和分页意图,不要将原查询参数直接复制到其他接口。

相关接口

相关指南

查看订阅方案 →