按区域、价格和面积搜索 Idealista 整栋建筑房源

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

返回某个地区的 Idealista 整栋建筑房源分页列表。必填参数为 locale、location(国家站点 es、it 或 pt)、locationId(例如马德里市镇的 0-EU-ES-28-07-001-079)、operation(sale 或 rent)、order(十二种排序方式之一)、maxItems 和 numPage。可选参数用于缩小范围:minPrice 与 maxPrice、minSize 与 maxSize、sinceDate 发布时间窗口(T、Y、W 或 M),以及只保留某个中介建筑房源的 micrositeShortName。该接口目前还没有记录到实际样例或响应示例,因此这里不列出响应字段;映射字段之前,请先检查你自己请求返回的内容。

API 功能

只返回整栋建筑房源 针对整栋建筑的出售或出租,而不是单套公寓,适合购入整栋楼后翻新或逐套转售的投资者。
价格区间与面积区间筛选 minPrice、maxPrice、minSize 和 maxSize 都以普通数字传入,把结果集限定在符合预算和建筑面积的楼宇范围内。
十二种排序,含每平方米价格 order 支持 relevance、lowestprice、highestprice、mostrecent、leastrecent、highestpricereduction、lowestpricem2、highestpricem2、biggest、smallest、highestfloors 和 lowestfloors。
通过 sinceDate 设置发布时间窗口 T 表示最近 24 小时(仅限租赁),Y 表示最近 48 小时(仅限出售),W 表示最近一周,M 表示最近一个月;留空则不限制日期。
按中介限定的建筑搜索 设置 micrositeShortName,只查看某一家中介发布的建筑房源,可据此构建该中介的房源组合视图。
逐页读取 numPage 从 1 开始,maxItems 设置每页条数,因此可以通过多次请求采集完整区域的结果。
国家与语言选择 location 在西班牙、意大利和葡萄牙站点之间切换,locale 接受 es、it、pt、en、ca、de、fr、nl 或 nb。

在线 API 演示

GET /api/project/idealista/list-buildings

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-buildings?key=<API_KEY>&locale=es&location=es&locationId=0-EU-ES-28-07-001-079&maxItems=30&numPage=1&operation=sale&order=relevance'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个接口返回哪一类房源?

返回 Idealista 上发布的整栋建筑,而不是单套公寓或独栋住宅。住宅、办公室或土地请使用对应的专用房源接口。

locationId 从哪里获取?

先用地区联想接口查询地点,再传入所选匹配项的 locationId。例如,0-EU-ES-28-07-001-079 就是该接口返回的马德里市镇。

sinceDate 的取值是什么意思?

T 表示最近 24 小时,只适用于租赁;Y 表示最近 48 小时,只适用于出售;W 表示最近一周;M 表示最近一个月。留空则不限制发布日期。

怎样翻页读取结果?

从 numPage=1 开始,每翻一页就增加它的值。maxItems 设置每页条数;文档中的取值为 30、40 和 0,其中 0 的含义没有说明。

有哪些排序方式?

relevance、lowestprice、highestprice、mostrecent、leastrecent、highestpricereduction、lowestpricem2、highestpricem2、biggest、smallest、highestfloors 和 lowestfloors。

可以只搜索某一家中介吗?

可以。在 micrositeShortName 中传入该中介的微站点短名称,搜索就会缩小到这家中介的建筑房源;省略则包含所有发布方。

这个接口返回哪些响应字段?

该接口目前没有记录到实际样例,所以这里没有记录字段清单。请用你自己的参数发起请求,并在编写解析器之前检查返回的 JSON。

相关接口

相关指南

查看订阅方案 →