旧版 v2 房产详情查询(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →通过已弃用的 v2 详情接口查询房产信息。唯一有文档说明的输入是必填查询参数 property_id,类型为字符串,取自房源列表结果。请原样保留标识:文档示例 O3599084026 以字母开头,转为数值可能改变请求。此接口未提供按地址、listing_id 或地理位置搜索的参数。 现有资料未记录此接口的实测响应。留存的旧版示例不完整且未经验证,不能据此确认接口当前可用,也不能视为完整的响应约定。示例可见部分包含 meta 对象及其中的 matching_rows、returned_rows、schema 字段,以及 properties 数组。房产字段包括结构化地址及其中的坐标、邮编、州代码、社区信息和 time_zone;还包括 beds、baths、baths_full、building_size.size、building_size.units、description,以及嵌套的 agents、broker、buyer_agent_for_far 和 buyer_office 对象。可见示例中的 cooling、heating 等可选属性为 null。 迁移房产详情页或缓存记录时,应将这个以数组承载房产的示例结构与替代接口的响应分别处理。不要假定响应顶层是单个房产对象,也不要假定字段齐全、嵌套结构稳定或两种结构可以直接互换。需区分请求获取失败、字段缺失和属性值为 null,并明确检查标识是否被原样保留、字段是否正确映射。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-v2-detail-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-detail-deprecated?key=<API_KEY>&property_id=<property_id>'
查询结果
使用场景
- 梳理旧版住宅房产门户中仅凭 property_id 访问的详情链接,以及缓存的 v2 响应数据。
- 用字母开头的 O3599084026 示例测试详情页请求构造逻辑,发现会破坏标识的数值转换。
- 替换详情接口前,整理旧版地址、社区、卧室与卫浴数量、建筑面积及经纪人员对象的字段映射清单。
- 在房产详情迁移适配器中,将获取失败与字段缺失、heating 或 cooling 为 null 分开处理。
- 对照存档的 properties 数组解析器与替代详情响应,不预设外层结构和嵌套方式一致。
常见问题
这个 v2 详情接口的 property_id 是数值吗?
不是。此接口将 property_id 声明为必填字符串,文档示例 O3599084026 以字母开头。应原样保留房源列表返回的值,不要转成数值,也不要用 listing_id 替代。
能改用地址或坐标查询房产详情吗?
按此接口已记录的请求参数不能这样查询。property_id 是唯一的查询参数,地址、坐标和 listing_id 均不属于文档列出的输入。
旧版示例返回的是单个房产对象吗?
未经验证的示例展示的是 properties 数组,以及含 matching_rows、returned_rows 的 meta 对象。这不能证明成功响应总是只有一条记录,也没有实测响应确认当前的外层结构。
留存示例中能看到哪些房产详情?
不完整的旧版示例包含结构化地址和社区信息、beds、baths、baths_full、带 size 和 units 的 building_size、description,以及嵌套的经纪人员对象。可见样本中的 heating 和 cooling 为 null。这些仅是示例字段,不保证当前实际响应会返回。
换用新版详情响应时,可以不修改解析器吗?
目前无法确认结构兼容。此接口已弃用,也没有实测响应记录。应逐项比较数组处理、字段路径、标识类型、面积单位及字段缺失或为 null 的情况,并将获取错误与属性缺失分别处理。