列出 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 自助仓储运营商选址:在决定开设门店之前,按城市和街区考察每平方米的挂牌租金。
- 小额投资者收益率筛选:比较同一个子地区内储藏室的售价与租金。
- 仓储运营商的竞品价格监控:每周保存一次竞争对手微站点的挂牌快照。
- 为没有地下储物间的公寓住户提供储藏室查找功能,嵌入找房或搬迁应用。
- 供给缺口分析:把仅计数的储藏室总数与住宅房源数量对比,找出 trasteros 很少的区县。
- 新房源提醒:针对选定的子地区轮询 sinceDate=W,有便宜的储藏室出现时发出通知。
常见问题
哪些参数是必填的?
必填的有七个: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 条。这是在办公室接口上说明的,储藏室接口没有单独确认,所以请先在你的地区测试,再依赖它。