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

原样传递字符串房产标识 将 property_id 按字符串发送,保留标识开头的字母,不要照搬其他旧版接口的数值类型转换逻辑。
核对 v2 详情的数组外层结构 未经验证的示例使用 properties 数组,并附有 meta.matching_rows 和 meta.returned_rows,可作为检查旧版响应解析器的迁移核对项。
映射详情地址与社区字段 旧版示例的可见部分将坐标、邮编、州代码、社区信息和 time_zone 嵌套在每条房产记录的 address 对象中。
成对保留建筑面积与单位 映射示例中的 building_size.size 时同时保留 building_size.units,不将面积数值当作无单位的独立值。
区分详情属性空值与获取失败 将旧版详情记录适配到新结构时,分别处理 heating 或 cooling 为 null、字段缺失及请求失败的情况。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个 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 的情况,并将获取错误与属性缺失分别处理。

相关接口

相关指南

查看订阅方案 →