按区域、价格和面积搜索 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在设定的价格与面积区间内扫描整栋出售的建筑,作为翻新或逐套转售的候选项目。
- 比较同一街区整栋建筑与单套公寓的每平方米价格。
- 把 sinceDate 设为最近一天或一周进行轮询,向投资者推送新上架的整栋建筑提醒。
- 在目标城市里寻找可改造为青年旅舍、公寓式酒店或合租公寓的楼宇。
- 通过 micrositeShortName 构建某个中介当前挂牌整栋建筑的组合视图。
常见问题
这个接口返回哪一类房源?
返回 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。