按 MLS 编号查询房源(已弃用)

查看 美国房产与房贷数据 API 的全部接口 →

此 MLS 编号查询接口已弃用,仅适用于维护、核查现有的旧版房源查询流程,不建议用于新接入。必填参数 mls_id 为字符串;可选参数 limit 和 offset 分别控制请求条数和跳过的条数。文档列出的排序值为 price_low、price_high、photos、newest 和 open_house_date。MLS 编号并不保证在所有 MLS 系统中全局唯一,对账时应同时保留所属 MLS 的信息。现有材料中没有实际请求返回的响应,只有未经验证的文档示例,包含 listings 数组、matching_rows 和 returned_rows 计数,以及 meta 对象。示例房源字段包括 property_id、listing_id、mls.id、mls.name、mls.abbreviation、address、address_new、beds、baths、prop_type、prop_sub_type、prop_status、price、price_raw、sqft、sqft_raw、photo_count、list_date 和 last_update。其中 address_new 包含 city、state_code、postal_code、lat 和 lon。示例中的 price 和 sqft 是用于展示的字符串,price_raw 为数值,sqft_raw 为 null;解析时应处理字段缺失和空值,不能假定所有金额、面积字段都是数值。上述示例字段不代表已经确认的当前响应约定。现行的通用房源搜索接口也不一定提供等效的 MLS 编号筛选,迁移前必须核实替代接口的实际行为。

API 功能

保留 MLS 编号查询约定 明确旧版接入必须传入 mls_id,同时区分 MLS 编号与全局唯一房产标识,避免将两者混用。
按偏移量翻页查找 MLS 房源 说明如何通过可选的 limit 和 offset 遍历匹配房源;现有资料未给出单页条数上限。
核对五种旧版 MLS 排序值 保留文档列出的 price_low、price_high、photos、newest 和 open_house_date,便于检查已有排序配置。
区分房源标识与 MLS 归属 标出未经验证示例中的 property_id、listing_id 和嵌套 mls 字段,供迁移核查时分别保留房源标识与所属 MLS 信息。

在线 API 演示

GET /api/project/realty-in-us/properties-list-by-mls-deprecated

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-by-mls-deprecated?key=<API_KEY>&mls_id=<mls_id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个已弃用的 MLS 查询接口需要哪些参数?

必须提供字符串类型的 mls_id;limit、offset 和 sort 为可选参数。此接口记录的是旧版 MLS 编号查询约定,不建议作为新接入的起点。

mls_id 可以与 property_id 或 listing_id 互换吗?

不可以。mls_id 是查询输入,而 property_id 和 listing_id 是文档示例中分别列出的响应字段。应保留相应的 MLS 归属信息,不要假定 MLS 编号具有全局唯一性。

MLS 查询结果如何分页和排序?

limit 指定请求的条数,offset 指定返回当前页前跳过的条数。文档列出的排序值为 price_low、price_high、photos、newest 和 open_house_date。现有材料未说明单页条数上限,也未保证排序结果的稳定性。

MLS 响应字段经过实际请求验证了吗?

没有。现有材料只有未经验证的文档示例,其中包含 listings、matching_rows、returned_rows、meta,以及房源层级的标识、地址、价格、卧室和卫浴数量、面积和 MLS 字段。无法确认这些字段当前是否返回,也无法确认其当前类型。

通用房源列表接口可以直接替代 MLS 编号查询吗?

现有证据不足以支持直接替换。迁移前,应核实替代接口是否明确支持所需的 MLS 编号查询,并结合原始 MLS 归属信息比对选定的房源记录。

相关接口

相关指南

查看订阅方案 →