列出 Idealista 新建楼盘中的住宅或车库单元

查看 Idealista 房源数据接口:西班牙、葡萄牙与意大利房产搜索 的全部接口 →

列出 Idealista 上某个新建楼盘(开发项目)的各个单元,文档将其描述为全新的住宅或车库。需要四个必填参数,没有分页或筛选参数:国家站点(location:es、pt 或 it)、响应语言(locale)、parentPromotionId(文档说明取自 promotionProperties 中的 promotionId)以及 propertyType(homes 或 garages,文档说明取自 promotionProperties 中的 propertyType)。文档中的示例楼盘 ID 是 104907187。该接口没有捕获到实际响应,所以其响应字段尚未验证。本 API 的新房房源样例中出现了 promoName 字段和新建楼盘标志,但没有专门的楼盘标识字段,因此在串联调用之前,请先在实际响应中确认 promotionProperties 的取值出现在哪里。

API 功能

单个楼盘的单元级视图 只需一个 parentPromotionId,就能把新建楼盘展开成其中包含的各套住宅或车库,而不是房源搜索里看到的一行汇总数据。
住宅与车库开关 propertyType 参数选择取回楼盘的住宅还是车库,车位附加项可以与住宅单元分开获取。
承接房源搜索结果 文档说明 parentPromotionId 和 propertyType 来自房源结果中的 promotionProperties 数据,因此该接口可作为新房搜索之后的下钻步骤。
仅四个参数的请求 只需要 locale、location、parentPromotionId 和 propertyType,没有页码、排序和筛选,让定时单元快照很容易自动化。
覆盖三个国家站点的楼盘 location 取 es、pt 或 it,locale 取九种语言代码,同一种调用方式适用于西班牙、葡萄牙和意大利的楼盘。
预填示例楼盘 预填了文档示例楼盘 ID 104907187,你可以立即发出第一次请求,先查看实际响应结构,再接入自己的 ID。

在线 API 演示

GET /api/project/idealista/list-promotion-properties

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-promotion-properties?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cpt%2Cit&parentPromotionId=104907187&propertyType=homes%2Cgarages'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个接口返回什么?

文档只把它描述为列出楼盘房源,即开发项目中全新的住宅或车库。没有捕获到实际响应,所以字段名称尚未验证;请先调用一次并检查返回的 JSON,再依赖具体字段。

parentPromotionId 从哪里获得?

文档说明取自房源结果中的 promotionProperties -> promotionId。本 API 的新房样例中出现了 promoName 字段和新建楼盘标志,但没有专门的楼盘标识字段,所以请检查实际响应以确定该值出现在哪里。

propertyType 取哪些值?

文档中的取值是 homes 和 garages,文档说明取自 promotionProperties -> propertyType。每次请求只传一个值;预填的 homes,garages 只是同时列出两种类型。

这个接口支持分页或筛选吗?

不支持。文档中的参数只有 locale、location、parentPromotionId 和 propertyType,没有页码、每页条数、排序、价格筛选或 locationId。

示例楼盘 ID 104907187 一直有效吗?

它是文档中的示例值。楼盘可能售罄或下架,因此它可能不再返回单元;请用最新房源结果中的有效 ID 替换。

支持哪些国家和语言?

location 接受 es(西班牙)、pt(葡萄牙)和 it(意大利),locale 接受 es、it、pt、en、ca、de、fr、nl 和 nb。各传一个代码;预填的值列出了可接受的选项。

相关接口

相关指南

查看订阅方案 →