列出 Idealista 出售或出租的办公室

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

返回 Idealista 上某一地区“购买/租赁 > 办公室”类别下的办公室房源分页列表。必填参数包括国家站点(location:es、it 或 pt)、响应语言(locale)、取自联想或子地区接口的 locationId、交易类型(operation:sale 或 rent)、排序方式、页码(numPage)和每页条数(maxItems,最大 40;取 0 只返回数量)。可选筛选涵盖价格与面积范围(minPrice、maxPrice、minSize、maxSize)、发布时间窗口(sinceDate:T 为最近 24 小时,仅限租赁;Y 为最近 48 小时,仅限出售;W 为最近一周;M 为最近一个月)、中介微站点短名称、楼宇类型(exclusive 表示纯办公楼宇,mixed 表示混合用途)、空间布局(openPlan 或 withWalls)、银行自有标志,以及 accessible、airConditioning、elevator、exterior、garage、hasPlan(户型图)、heating、hotWater 和 security 等布尔设施标志。该接口没有捕获到实际响应,所以其响应字段尚未验证;预计它沿用本 API 新房房源接口中看到的分页房源结构(包含房源数组 elementList,以及 total、totalPages 和 actualPage),请在第一次调用时加以确认。

API 功能

办公室设施标志 accessible、airConditioning、elevator、exterior、garage、heating、hotWater 和 security 等布尔开关,让你只保留标明了租户所需设施的办公室。
楼宇类型与布局筛选 buildingType 区分纯办公用途楼宇(exclusive)和混合用途楼宇(mixed),layout 区分开放式(openPlan)与隔墙分隔(withWalls)的楼层。
户型图与银行自有开关 hasPlan 保留带户型图的房源,bankOffer 针对银行自有办公室,有助于筛出资料齐全或处置类的库存。
出售与出租的预算范围 minPrice、maxPrice、minSize 和 maxSize 把搜索限定在你需要的预算和建筑面积内,按交易类型分别应用于售价或租金。
按天、周、月查看新上架办公室 sinceDate 把结果限制在最近 24 小时(T,仅限租赁)、48 小时(Y,仅限出售)、一周(W)或一个月(M)内发布的办公室,适合租户代理提醒。
每平方米价格与楼层数排序 order 参数文档列出十二个取值,包括 lowestpricem2、highestpricem2、biggest、smallest、highestfloors 和 lowestfloors,对标和楼层排名无需在客户端再排序。
快速的办公室库存计数 把 maxItems 设为 0 只返回房源数量,响应很快,可以在逐页读取完整结果之前,估算多个地区的办公室供应量。
单个中介的办公室组合 可选的 micrositeShortName 参数把搜索限定在一个中介微站点,方便你核对某位经纪人当前挂牌的办公室库存。

在线 API 演示

GET /api/project/idealista/list-offices

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-offices?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cit%2Cpt&locationId=<locationId>&maxItems=30%2C40%2C0&numPage=<numPage>&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。其余全部可选,包括价格与面积范围、设施标志、buildingType、layout 和 sinceDate。

有哪些办公室专用的筛选条件?

accessible、airConditioning、elevator、exterior、garage、heating、hotWater、security 和 hasPlan(户型图)布尔标志,以及 buildingType、layout 和 bankOffer。它们全部可选,你只需要组合自己需要的条件。

buildingType 和 layout 接受哪些值?

buildingType 接受 exclusive(纯办公用途楼宇)和 mixed(混合用途楼宇),留空表示不限。layout 接受 openPlan(开放式办公室)和 withWalls(隔墙分隔的办公室),留空表示不限。

响应是什么样子?

该接口没有捕获到实际响应,所以其字段尚未验证。本 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=relevance、maxItems=30。

每页最多可以请求多少间办公室?

最大值为每页 40 条,超过的部分会被忽略。把 maxItems 设为 0 则快速返回房源数量。结果较多时,从 1 开始递增 numPage 逐页读取。

bankOffer 筛选条件应该怎么传?

文档只把 bankOffer 描述为“银行自有”,并将其类型标为文本而不是布尔值,没有列出可接受的取值。请在目标地区试用 bankOffer=true,并确认结果数量随之减少,然后再依赖它。

相关接口

相关指南

查看订阅方案 →