列出 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 功能

土地类型开关 urban、buildingLand 和 nonBuildingLand 三个布尔标志,可分别锁定城市用地、可建设地块或不可建设(乡村)地块,而不是把所有地块类型混在同一个结果里。
价格与地块面积区间 minPrice、maxPrice、minSize 和 maxSize 把搜索限定在你关心的预算和地块面积内,让小花园地块和大型乡村庄园在服务端就能分开。
新上架地块的时间窗口 sinceDate 把结果限制在最近 24 小时(T,仅限租赁)、48 小时(Y,仅限出售)、一周(W)或一个月(M)内发布的地块,适合对新挂牌土地做提醒。
按中介限定的土地搜索 可选的 micrositeShortName 参数把搜索限定在单个中介微站点,帮助你核对某位土地经纪人当前挂牌的地块。
单价与面积排序 order 参数接受文档列出的十二个取值,包括 lowestpricem2、highestpricem2、biggest 和 smallest,每平方米最便宜或面积最大优先的排名无需在客户端再排序。
三个国家、九种语言 用 location(es、it、pt)选择国家站点,用 locale(es、it、pt、en、ca、de、fr、nl、nb)选择文本语言,各市场沿用同一套 locationId 流程。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

可以按哪些土地类型筛选?

提供三个可选的布尔标志: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 逐页读取。

相关接口

相关指南

查看订阅方案 →