按 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 编号视作全局主键。
- 按 MLS 文档示例构造解析测试,覆盖格式化价格、面积字符串、原始数值以及可能为 null 的 sqft_raw。
- 迁移 MLS 编号查询流程前,核实替代接口是否明确支持相同的编号筛选。
常见问题
这个已弃用的 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 归属信息比对选定的房源记录。