列出出售或出租的商业铺位

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

返回单个地区的一页 Idealista 商业铺位房源。必填参数:locationId(Idealista 地区 ID,例如 0-EU-ES-28-07-001-079,可通过联想和子地区接口获得)、location(国家站点:es、it 或 pt)、locale(语言代码:es、it、pt、en、ca、de、fr、nl 或 nb)、operation(sale 或 rent)、order(从 relevance 到 lowestfloors 的十二种排序之一)、maxItems(列出的取值为 30、40 和 0)以及 numPage(页码,示例为 1)。可选参数用来缩小范围:minPrice、maxPrice、minSize 和 maxSize;通过 sinceDate 设置发布时间窗口(T 为最近 24 小时,仅限租赁;Y 为最近 48 小时,仅限出售;W 为最近一周;M 为最近一个月);通过 micrositeShortName 限定中介;按铺位类型(premises、industrialBuilding、storehouse 以及三个 saleWarehouse 标志);按经营业态(例如 pharmacy、catering、retail、barsAndNightclub、accommodation);以及按所处位置(street、mezzanine、ontopfloor、underground、shoppingcenter、otherLocations)。该接口没有附带实际响应样例或响应结构,因此这里无法验证房源字段:映射字段之前请先检查实际响应。多个布尔标志如何组合文档没有说明,请自行测试你所依赖的组合。

API 功能

按地区 ID 搜索铺位 通过 locationId(例如 0-EU-ES-28-07-001-079)搜索任何 Idealista 区域,ID 取自联想和子地区接口,可以从城市一路下钻到区县。
按经营业态筛选铺位 共有十四个业态布尔标志,包括 pharmacy、catering、retail、barsAndNightclub、educationalCenter、laboratory、tobaccoShop 和 sportsFacilities,把结果缩小到适合某类生意的铺位。
临街、夹层与购物中心位置 street、mezzanine、ontopfloor、underground、shoppingcenter 和 otherLocations 标志,区分临街门面与顶层、地下和商场内的铺位。
仓库出售结构筛选 saleWarehouseOnly、saleWarehouseThirdPartiesRented 和 saleWarehouseWithBusinessTransfer,配合 industrialBuilding 和 storehouse,可以按出售方式划分工业类房源的供应。
价格、面积与发布时间区间 minPrice、maxPrice、minSize 和 maxSize 限定搜索范围,sinceDate 则把结果限制在最近 24 小时(租赁)、48 小时(出售)、一周或一个月内发布的房源。
十二种排序与分页控制 通过 order 按相关度、价格、每平方米价格、面积、楼层数、发布时间或降价幅度对铺位排序,并用 numPage 和 maxItems 逐页读取结果集。
三个国家站点,九种语言 location 参数选择西班牙、意大利或葡萄牙站点,locale 接受 es、it、pt、en、ca、de、fr、nl 或 nb 作为请求语言。

在线 API 演示

GET /api/project/idealista/list-commercial-properties

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

怎样获得商业房源搜索所需的 locationId?

用联想接口把地名解析为地区 ID,再用子地区接口从城市下钻到各区县。文档中的示例 ID 是 0-EU-ES-28-07-001-079。

哪些参数是必填的?

必填的查询参数共七个:locationId、location、locale、operation、order、maxItems 和 numPage。所有价格、面积、日期、中介和铺位类型筛选条件都是可选的。

怎样只搜索药房、酒吧或其他业态?

把对应的布尔标志设为 true,例如 pharmacy、catering、barsAndNightclub、retail、accommodation 或 tobaccoShop。文档没有说明多个标志是按“且”还是“或”组合,请自行测试你需要的组合。

sinceDate 筛选条件怎么用?

留空表示不限制日期;也可以用 T 表示最近 24 小时(仅限租赁),Y 表示最近 48 小时(仅限出售),W 表示最近一周,M 表示最近一个月。

怎样翻页和排序?

递增 numPage(文档示例为 1),并选择一个 order 值,例如 relevance、lowestprice、highestprice、mostrecent、biggest 或 lowestpricem2。maxItems 列出的取值为 30、40 和 0,其中 0 的含义没有说明。

可以在一次调用中同时搜索出售和出租吗?

文档把 sale 和 rent 列为两个 operation 取值。每次请求只传其中一个,这样结果以及 sinceDate 选项(T 仅限租赁,Y 仅限出售)才不会产生歧义。

支持哪些国家和语言?

location 选择国家站点(es、it 或 pt),locale 接受 es、it、pt、en、ca、de、fr、nl 或 nb。请使用与所选站点同一国家的 locationId。

每条房源包含哪些字段?

该接口目前没有附带实际探测结果或响应示例,所以这里没有验证字段名称。请先用你的参数调用一次,并在建立数据结构之前检查返回的 JSON。

相关接口

相关指南

查看订阅方案 →