使用成对房源与房产标识获取旧版房产详情(已弃用)

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

此旧版房产详情接口仅保留用于兼容与迁移,不建议新项目使用。查询时必须同时提供三个字符串参数:listing_id、property_id 和 prop_status。文档说明 listing_id 与 property_id 应取自房源搜索结果,包括旧版及第二版房源列表接口的结果。务必使用同一条搜索记录中的房源标识与房产标识;两者含义不同,不可相互替代。prop_status 的文档可选值为 for_sale 和 for_rent。listing_id=608763437、property_id=4599450556 等仅为示例,并非已核验的当前有效记录。 目前没有本接口的请求核验记录,因此接口可用性、标识有效性及当前响应约定均未确认。不完整的文档示例使用顶层 listing 对象,其 address 部分展示 city、county、state、state_code、postal_code、line、lat、long、neighborhood_name、neighborhoods 和 time_zone。其他可见 listing 字段包括 beds、baths、baths_full、advertiser_type、agent、branding、broker、client_display_flags、client_display_text、client_event_data 和 client_provider_data。上述均只是文档示例字段,不能保证当前仍会返回、内容完整,或与新版详情响应等价。 迁移前应先盘点已存储的标识组合与状态值,再单独确认当前详情接口的输入要求和输出结构,之后再调整链接或字段映射。接口已弃用并不意味着已有明确下线日期,也不保证服务会持续可用。

API 功能

成对保留房源与房产标识 要求 listing_id 和 property_id 来自同一条房源搜索记录,保留各自含义,不能将同一个值填入两个标识位置。
旧版出售或出租状态选择 按文档将 prop_status 设为 for_sale 或 for_rent,让旧版请求保留与标识组合对应的房源状态。
旧版 listing 响应结构参考 未经核验且不完整的示例将地址信息以及 beds、baths、baths_full 等字段放在 listing 下,当前是否仍提供这些字段尚未确认。
历史详情链接兼容性盘点 利用三个必填参数的约定检查旧链接与历史数据记录,再选择并核验迁往当前详情接口的映射关系。
明确弃用接口的迁移边界 仅将此接口用于旧系统兼容,不承诺持续可用、具体下线日期,或与新版响应逐字段兼容。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

新应用应该使用这个房产详情接口吗?

不应该。此接口已明确弃用,仅保留用于旧系统兼容与迁移。新项目应在确认当前详情接口自身的入参要求与响应结构后,使用当前接口。

listing_id 和 property_id 都必须提供吗?

是的。这两个字符串参数与 prop_status 均为必填。两个标识应来自同一条房源搜索结果,文档指向旧版及第二版列表结果。不要用一个标识值代替另一个。

prop_status 支持哪些文档值?

文档列出的值为 for_sale 和 for_rent。应使用房源记录对应的状态,不要根据标识自行推断。目前没有使用当前记录核验任一状态的请求记录。

示例标识一定能查到房产吗?

不能保证。示例房源标识和房产标识只是文档示例,并非已核验的当前有效记录。应从适当的房源列表结果取得匹配的一对标识,不要将占位示例当成已知可用的房产。

这个已弃用接口有哪些已经确认的响应字段?

尚无字段经过请求核验。不完整的文档示例展示了 listing.address、beds、baths、baths_full、advertiser_type、agent、branding、broker 及客户端相关部分,但它们当前是否存在、是否完整仍未确认。

迁移时只替换详情 URL 就可以了吗?

不能这样假定。应先盘点已存储的 listing_id、property_id 和 prop_status,再确认当前详情接口要求的标识与字段路径。接口已弃用并不证明新旧响应布局相同,也没有据此确定下线日期。

相关接口

相关指南

查看订阅方案 →