根据房产 ID 获取美国房产详情

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

使用房产搜索结果中的必填 property_id,获取选定美国住宅的详情。可选 listing_id 用于传入搜索结果中的具体房源上下文,不能替代 property_id。两个输入都是字符串查询参数。 实测成功响应将房产放在 data.home 下,返回了 property_id、listing_id、list_price、last_update_date、地址信息、描述文本和照片。该次核验记录的 list_price 为 1325000,包含 75 张照片;这只是单条记录的观测结果,不是固定取值,也不保证其他房产具有相同的媒体覆盖。last_update_date 应理解为返回记录的时间戳,不能据此保证整个房源数据集的时效性。 判断结果时,必须同时检查响应体和 HTTP 状态。实测无效 property_id 返回了 HTTP 200,但 data.home 为 null,且 errors 中包含 extensions.code=HTTP_ERROR 和 extensions.data.code=500。不能把所有 HTTP 200 都视为已找到房产,也不能把所有空房产结果都当作没有错误的“未找到”。 接口文档提及 Home Value(房屋价值)功能,但现有成功实测并未确认估值字段名称、自动估值模型或历史估值序列。保留的文档示例已截断,偏重房源信息且未经验证,不应据此推翻实测的 data.home 响应结构。

API 功能

对应房产与具体房源标识 使用必填 property_id 和可选 listing_id 发起查询,再将 data.home 返回的标识与选定搜索结果关联。
结合记录时间展示挂牌价 实测房产包含 list_price 和 last_update_date,便于同时展示挂牌价与记录时间戳,但不承诺所有房源具有统一的新鲜度。
丰富选定住宅的图文详情 核验的详情记录包含地址信息、描述文本和 75 张照片,可用于完善住宅详情页;具体内容是否齐全因房产而异。
识别成功状态码内的错误 即使返回 HTTP 200,也应处理 data.home=null 和 errors,包括实测的 HTTP_ERROR 错误及其内嵌的 500 代码。

在线 API 演示

GET /api/project/realty-in-us/properties-v3-detail

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

property_id 和 listing_id 应从哪里获取?

使用房产列表接口返回的 property_id;它是此接口的必填参数。如果选定搜索结果还提供 listing_id,可以将其作为可选的房源上下文传入,但 listing_id 不能替代 property_id。

成功响应中的房产详情位于哪里?

已验证的成功响应将房产放在 data.home 下,包含 property_id、listing_id、list_price、last_update_date、地址信息、描述文本和照片。该次观测不保证每处房产都会提供所有这些内容。

HTTP 200 是否表示已经找到请求的房产?

不是。一次无效 property_id 请求返回了 HTTP 200,但 data.home 为 null,errors 中包含 extensions.code=HTTP_ERROR 和 extensions.data.code=500。在展示成功的详情页之前,应同时检查房产值和错误数组。

可以依赖此接口提供自动房屋估值吗?

现有证据不足以支持这一用途。接口文档提及 Home Value,但成功实测并未确认估值字段、字段含义或历史估值序列。提供估值功能之前,应先验证这些字段。

last_update_date 能保证整个房源数据集都是最新的吗?

不能。它只是单条记录返回的时间戳。该次观测不能确定刷新周期或记录最长多久未更新,也不能证明数据覆盖全部美国房源。

相关接口

相关指南

查看订阅方案 →