列出 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为经纪人和业主做区级办公室每平方米租金对标:用 lowestpricem2 排序,并用 minSize 与 maxSize 限定范围。
- 创业公司总部选址:在预约看房之前,先按面积、价格、电梯、空调和无障碍条件筛选。
- 面向设施经理的设施优先办公室候选清单:组合供暖、热水、安保和布局筛选。
- 混合办公需求的替代指标:每周保存各区的办公室供应数量快照(maxItems=0),并绘制趋势图。
- 企业搬迁报告:比较马德里、巴塞罗那和瓦伦西亚的可租办公室库存和挂牌租金。
- 租户代理提醒:用 sinceDate=T 轮询租赁房源,有符合条件的办公室出现时发出通知。
- 投资者的银行自有办公室机会筛选:把 bankOffer 与最高价格和最小面积组合使用。
常见问题
哪些参数是必填的?
必填的有七个: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,并确认结果数量随之减少,然后再依赖它。