列出出售或出租的商业铺位
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 连锁品牌选址:在选定街道、符合面积区间的范围内,筛选药房、咖啡馆、健身房、美容或教育类铺位。
- 零售租金对标:把 street 标志与面积和价格区间组合,比较不同街道或街区铺位的挂牌租金。
- 餐饮场地踩点:为寻找新址的经营者列出某个区的酒吧、夜总会和餐饮铺位。
- 工业供应跟踪:借助 industrialBuilding、storehouse 和 saleWarehouse 标志,为物流买家和投资者留意仓库与工业建筑的库存。
- 购物中心拓展研究:用 shoppingcenter 标志找出商场内的铺位,服务进入西班牙、意大利或葡萄牙市场的品牌。
- 新房源提醒:把 sinceDate 设为 W 或 M 并将 order 设为 mostrecent 进行轮询,及时发现刚刚发布的商业铺位。
常见问题
怎样获得商业房源搜索所需的 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。