根据房产 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 一并传入详情请求,并展示返回的两个标识,以便核对记录关联。
- 将返回的挂牌价与该条记录的更新时间并列展示,同时处理缺失字段。
- 即使 HTTP 状态为 200,也检查 data.home 和 errors,识别未能正常获取房产的响应。
常见问题
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 能保证整个房源数据集都是最新的吗?
不能。它只是单条记录返回的时间戳。该次观测不能确定刷新周期或记录最长多久未更新,也不能证明数据覆盖全部美国房源。