查询旧版房源详情(已弃用)

查看全部 Realtor 美国房产数据 API →

旧版详情接口要求同一搜索记录中的 propertyId 与 listingId,文档已标记弃用,且本接口未实测,响应字段和持续可用性未确认。保留它用于已有集成参考,不推荐新项目以此开始。新开发应优先使用 property-v2-detail,将当前搜索取得的 property_id 作为 query。迁移前比较真实字段可用性,并保持房产身份与挂牌身份的区别。

API 功能

明确弃用的兼容入口 仅为已有客户端保留参考,不是新详情集成的推荐方案。
旧版必填双标识 propertyId 和 listingId 都必填,必须描述同一条搜索挂牌。
迁移到已实测 v2 查询 property-v2-detail 可将当前搜索 property_id 作为 query。
逐字段评估旧版替换 旧响应未观察,应先对照实际字段,再替换生产环境解析逻辑。

在线 API 演示

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

API 响应 (JSON)

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

使用场景

常见问题

新项目还应该从旧版 /detail 开始吗?

不建议。该接口已弃用且未实测,新开发优先参考 property-v2-detail,并从当前搜索取得 property_id。

旧版需要的 propertyId 与 listingId 能来自不同记录吗?

不能。必须从同一搜索挂牌取出房产和挂牌标识,混用可能错误关联;旧 ID 组合的实际行为也未验证。

迁移到 v2 是否可以直接不做字段检查?

不可以。旧版响应未观察,应比较实际可用字段、空值与业务依赖,再替换解析器,同时把双 ID 输入改为 v2 query。

相关接口

使用指南

查看订阅方案 →