列出 Idealista 出售或出租的土地地块
查看 Idealista 房源数据接口:西班牙、葡萄牙与意大利房产搜索 的全部接口 →返回 Idealista 上某一地区出售或出租的土地地块分页列表。必填参数包括国家站点(location:es、it 或 pt)、响应语言(locale)、取自联想或子地区接口的 locationId、交易类型(operation:sale 或 rent)、排序方式、页码(numPage)和每页条数(maxItems)。可选筛选条件包括土地类型(urban 城市用地,buildingLand 可建设地块,nonBuildingLand 不可建设地块)、最低与最高价格、最小与最大地块面积、发布时间窗口(sinceDate:T 为最近 24 小时,仅限租赁;Y 为最近 48 小时,仅限出售;W 为最近一周;M 为最近一个月),以及中介微站点短名称。该接口没有捕获到实际响应,所以其响应字段尚未验证;预计它沿用新房房源接口中看到的分页房源结构(包含房源数组 elementList,以及 total、totalPages 和 actualPage),请在第一次调用时加以确认。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/idealista/list-lands API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-lands?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cit%2Cpt&locationId=0-EU-ES-28-07-001-079&maxItems=30%2C40%2C0&numPage=1&operation=sale%2Crent&order=relevance%2Clowestprice%2Chighestprice%2Cmostrecent%2Cleastrecent%2Chighestpricereduction%2Clowestpricem2%2Chighestpricem2%2Cbiggest%2Csmallest%2Chighestfloors%2Clowestfloors'
查询结果
使用场景
- 为开发商做土地储备踩点:在竞标或签订期权之前,标记出某个市镇内的城市用地和可建设地块。
- 利用价格和面积筛选,比较各市镇可建设与不可建设地块的每平方米价格。
- 新地块提醒:针对一组子地区轮询 sinceDate=W 或 sinceDate=M,有新地块出现就发出通知。
- 为自建房、农业或离网项目寻找乡村地块:把 nonBuildingLand 与最高价格组合使用。
- 在相邻的子地区之间做供应对比,决定把土地收购力量集中到哪里。
- 核查中介的土地库存:把搜索限定到一个微站点短名称,跟踪其地块存量的变化。
常见问题
可以按哪些土地类型筛选?
提供三个可选的布尔标志:urban 表示城市用地,buildingLand 表示可建设地块,nonBuildingLand 表示不可建设(乡村)地块。文档没有说明组合标志时的行为,请在目标地区测试你需要的组合。
响应是什么样子?
该接口没有捕获到实际响应,所以其字段尚未验证。同系列的新房接口返回带有 elementList 房源数组和分页字段(total、totalPages、actualPage、itemsPerPage)的对象;土地结果预计使用相同的结构,但在依赖具体字段名之前请先用第一次调用确认。
怎样获得有效的 locationId?
用本 API 的联想接口把地名解析为 ID,再用子地区接口下钻到区县或街区。示例 ID 0-EU-ES-28-07-001-079 在一次新房样例调用中解析为马德里;ID 中的国家段应与 location 参数一致。
为什么有些字段预填了多个值?
locale、location、operation、order 和 maxItems 文档中的默认值列出了可接受的选项(例如 sale,rent 和 30,40,0)。每次请求请替换成单个值,例如 operation=sale、order=relevance、maxItems=30。
sinceDate 的取值是什么意思?
sinceDate 留空表示不按时间筛选。T 表示最近 24 小时,仅用于租赁;Y 表示最近 48 小时,仅用于出售;W 表示最近一周;M 表示最近一个月。
每页最多可以请求多少个地块?
本 API 的房源接口文档中的最大值为每页 40 条,取值 0 则只返回结果数量。该接口预填 30,40,0,与这些值一致,但土地接口的上限并未单独确认;请用 numPage 逐页读取。