列出 Idealista 新建楼盘中的住宅或车库单元
查看 Idealista 房源数据接口:西班牙、葡萄牙与意大利房产搜索 的全部接口 →列出 Idealista 上某个新建楼盘(开发项目)的各个单元,文档将其描述为全新的住宅或车库。需要四个必填参数,没有分页或筛选参数:国家站点(location:es、pt 或 it)、响应语言(locale)、parentPromotionId(文档说明取自 promotionProperties 中的 promotionId)以及 propertyType(homes 或 garages,文档说明取自 promotionProperties 中的 propertyType)。文档中的示例楼盘 ID 是 104907187。该接口没有捕获到实际响应,所以其响应字段尚未验证。本 API 的新房房源样例中出现了 promoName 字段和新建楼盘标志,但没有专门的楼盘标识字段,因此在串联调用之前,请先在实际响应中确认 promotionProperties 的取值出现在哪里。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 楼盘详情页:把楼盘展开成各个住宅单元,让买家看到每一套在售单元。
- 销售节奏跟踪:每天保存楼盘单元快照,统计两次运行之间消失了多少套。
- 同一区域竞争楼盘的户型组合对比,按各楼盘仍在出售的产品分组。
- 为开发商销售团队搭建的销售顾问看板,列出每个楼盘的剩余单元。
- 车位附加项查找:请求 propertyType=garages,查看新建楼盘附带哪些车库单元。
- 期房买家对比表:对多个楼盘 ID 调用该接口,把各单元并排比较。
常见问题
这个接口返回什么?
文档只把它描述为列出楼盘房源,即开发项目中全新的住宅或车库。没有捕获到实际响应,所以字段名称尚未验证;请先调用一次并检查返回的 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。各传一个代码;预填的值列出了可接受的选项。