Realtor 房源详情 API - 通过 property_id 获取房产介绍与图片

将搜索结果中的 property_id 作为 query，补充所选房源详情。文档还列出房源 URL、完整地址与地址式 ID 输入，但只有 property_id 形式已实测。测试中的详情与搜索记录的 property_id、listing_id、地址及 list_price 一致，返回 status=true、message 和 data 对象。已观察字段包括房源状态、地址与坐标、description.text 及房屋属性、photo_count、photos[].href、mortgage.estimate、mortgage.average_rates、hoa、details、tax_history、property_history、last_sold_date、last_sold_price、last_update_date。不同房产可能缺少部分字段，应保留空值并记录查询时间。金融信息只是估算，不是贷款要约。跟随示例时建议先取得最新搜索 ID，因为挂牌可能变化或失效。

API 功能

实测搜索到详情身份一致 已验证示例中的 property_id 与 listing_id 均与所选在售搜索记录一致。

房屋文字与结构属性 观察到 description 含介绍文本、房间数量、建造年份及其他可为空的属性。

房源图库与历史字段 检查过的详情对象包含 photos、photo_count、property_history 与 tax_history。

结合更新时间解读估算 last_update_date 与房贷估算、参考利率可供背景展示，但不保证时效或实际贷款条件。

在线 API 演示

GET /api/project/realtor/property-v2-detail

API 响应 (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-v2-detail?key=<API_KEY>&query=3196769134'

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-v2-detail?key=<API_KEY>&query=3196769134'

📢

需要帮助？

如遇接口异常，或需要其他接口需求，可联系我们

联系我们

使用场景

用户选中搜索结果后，按需打开完整房源详情页面。
补充收藏房产记录，同时区分早期搜索快照和后来取得的详情。
对照房屋介绍与结构化属性，找出尽调前仍缺失的信息。
在房源旁展示可用房贷估算，并明确注明非约束性的预算参考。

常见问题

拿到 property_id 后如何查询详情和图片？

把当前搜索结果中的 property_id 作为 query 提交到本接口。实测详情包含 data.description.text 与 photos[].href；每套房的字段可用性不同，不能保证都有图片或完整文字。

可以直接传完整地址或 Realtor 房源链接吗？

文档列出了这些 query 形式，但本轮只验证了 property_id。地址和链接形式应单独测试并核对返回身份，不能沿用 ID 形式的成功结论。

详情里的 mortgage 数值可以当正式贷款报价吗？

不可以。mortgage.estimate 和 mortgage.average_rates 只是可用的估算背景，应核对日期和假设，不代表贷款批准、适用利率或金融机构的约束性报价。

使用指南

查看订阅方案 →

通过房产 ID 获取完整房源详情