Realtor 房源介绍 API - 按 propertyId 与 listingId 查询文字

propertyId 与 listingId 必须来自同一条搜索结果，已实测搜索中对应 data[].property_id 和 data[].listing_id。此接口用于单独读取挂牌介绍，但尚未实测，文字字段名、响应结构及旧 ID 组合的行为未确认。不要把一套房的 propertyId 与另一条挂牌的 listingId 混在一起。需要已验证的介绍字段时，property-v2-detail 曾返回 data.description.text 及完整详情。展示房源文字前仍须确认内容使用权。

API 功能

介绍查询使用成对标识 propertyId 和 listingId 都必填，且应来自同一条发现的挂牌记录。

面向挂牌文字的读取用途 该接口用于介绍查询，不代表已验证完整详情接口的字段集合。

保留挂牌版本关系 同一房产不同时期可能对应不同挂牌 ID，应始终一起保存选定标识对。

先确认介绍文本字段 尚未观察本接口的文字响应，渲染前需验证实际字段路径与内容权限。

在线 API 演示

GET /api/project/realtor/property-get-descriptions

API 响应 (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-get-descriptions?key=<API_KEY>&propertyId=<propertyId>&listingId=<listingId>'

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-get-descriptions?key=<API_KEY>&propertyId=<propertyId>&listingId=<listingId>'

📢

需要帮助？

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

联系我们

使用场景

验证返回结构后，为选定挂牌按需加载获授权的介绍文字。
在人工房源质量审核中，将文案描述与房屋结构属性对照。
检查同一房产在不同 listingId 下的介绍是否发生变化。
为无需图库的编辑审核队列评估仅文字查询流程。

常见问题

propertyId 和 listingId 从哪里获得？

先查询当前房源列表，从同一条结果取出 property_id 和 listing_id，分别作为 propertyId 与 listingId。两者标识不同层级，不可互换或跨记录组合。

文字是否一定在 data.description.text？

该路径只在已实测的 property-v2-detail 中确认过。此专用介绍接口未实测，不能直接假定使用相同字段。

房产 ID 不变时能一直复用旧 listingId 吗？

不应假设可以。同一房产可能重新挂牌，旧组合的行为也未确认。请保存配对关系，并优先用当前搜索结果核对挂牌身份。

使用指南

查看订阅方案 →

通过匹配的房产与挂牌 ID 查询介绍