列出 Idealista 出售或出租的储藏室

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

返回 Idealista 上某一地区出售或出租的储藏室(trasteros)分页列表。必填参数包括国家站点(location:es、it 或 pt)、响应语言(locale)、取自联想或子地区接口的 locationId、交易类型(operation:sale 或 rent)、排序方式、页码(numPage)和每页条数(maxItems)。可选筛选仅限最低与最高价格、最小与最大面积、发布时间窗口(sinceDate:T 为最近 24 小时,仅限租赁;Y 为最近 48 小时,仅限出售;W 为最近一周;M 为最近一个月)以及中介微站点短名称;没有设施标志。该接口没有捕获到实际响应,所以其响应字段尚未验证;预计它沿用本 API 新房房源接口中看到的分页房源结构(包含房源数组 elementList,以及 total、totalPages 和 actualPage),请在第一次调用时加以确认。

API 功能

按地区 ID 搜索储藏室 取自联想或子地区接口的 locationId 把搜索限定在一个城市、区县或街区,只返回该区域的储藏室房源。
出售与出租共用同一种调用 operation 参数在出售和出租之间切换,其他输入无需更改,所以一次集成即可覆盖购买与租赁两个市场。
精简的价格与面积区间 minPrice、maxPrice、minSize 和 maxSize 让结果保持在你需要的预算和面积范围内,在服务端把小型储物柜和较大的储藏单元区分开。
新上架储藏室提醒 sinceDate 把结果限制在最近 24 小时(T,仅限租赁)、48 小时(Y,仅限出售)、一周(W)或一个月(M)内发布的储藏室,适合新房源通知。
按每平方米挂牌租金排名 order 参数在十二个文档取值中包含 lowestpricem2 和 highestpricem2,每平方米最便宜或最贵的储藏空间会排在最前。
通过微站点名称查看运营方库存 micrositeShortName 把搜索限定在一个中介或运营方的微站点,方便你跟踪单个发布方当前挂牌的储藏室存量。
无需设施参数的请求 与办公室和住宅搜索不同,这个接口没有设施或房源类型标志,请求只需要地区、语言、交易类型、排序和分页参数。

在线 API 演示

GET /api/project/idealista/list-storage-rooms

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-storage-rooms?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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

哪些参数是必填的?

必填的有七个:location(es、it 或 pt)、locale、locationId、operation(sale 或 rent)、order、numPage 和 maxItems。价格范围、面积范围、sinceDate 和 micrositeShortName 是可选的。

有储藏室专用的筛选条件吗?

文档中的筛选条件是 minPrice、maxPrice、minSize、maxSize、sinceDate 和 micrositeShortName。与办公室接口不同,这里没有设施、楼宇类型或布局标志。

响应是什么样子?

该接口没有捕获到实际响应,所以其字段尚未验证。本 API 的新房房源接口返回带有 elementList 数组和分页字段(total、totalPages、actualPage、itemsPerPage)的对象;储藏室结果预计使用相同的结构,但在依赖具体字段名之前请先用第一次调用确认。

怎样获得有效的 locationId?

用本 API 的联想接口把地名解析为 ID,再用子地区接口下钻到区县或街区。文档中的示例 ID 是 0-EU-ES-28-07-001-079,ID 所属国家应与 location 参数一致。

sinceDate 的取值是什么意思?

sinceDate 留空表示不按时间筛选。T 表示最近 24 小时,仅适用于租赁;Y 表示最近 48 小时,仅适用于出售;W 表示最近一周;M 表示最近一个月。

为什么有些字段预填了多个值?

locale、location、operation、order 和 maxItems 文档中的默认值列出了可接受的选项,例如 sale,rent 和 30,40,0。每次请求请替换成单个值,例如 operation=rent、order=lowestpricem2、maxItems=30。

可以只获取储藏室的数量吗?

本 API 的房源接口文档把 maxItems=0 描述为仅计数的请求,并把每页上限定为 40 条。这是在办公室接口上说明的,储藏室接口没有单独确认,所以请先在你的地区测试,再依赖它。

相关接口

相关指南

查看订阅方案 →