把地名自动补全为 Idealista 地区 ID

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

根据地名的开头几个字,在西班牙、葡萄牙或意大利解析出匹配的 Idealista 地区。请求时传入 location(es、pt 或 it)、operation(sale 或 rent)、prefix(目前已输入的文字,例如 madrid)以及 propertyType(homes、newDevelopments、bedrooms、offices、premises、garages、lands、storageRooms 或 buildings),四个参数全部必填。响应是一个 JSON 对象,包含 locations 数组和整数 total。在 location=es、operation=sale、prefix=madrid、propertyType=homes 的实际检查中,每个 locations 条目都带有 name、locationId、divisible、type、suggestedLocationId、subTypeText 以及自己的 total,匹配结果混合了市镇、马德里省和各个区。每个条目的 total 统计所选交易类型和房源类型下在售或在租的房源数量,而 locationId 正是各房源接口的 locationId 参数所需要的标识。

API 功能

按前缀联想地名 输入城市、省份或区的前几个字母,就能返回匹配的 Idealista 地点,正是输入即搜索框所期望的方式。
可直接使用的 locationId 每个匹配项都带有 locationId(例如马德里市镇的 0-EU-ES-28-07-001-079)和数字形式的 suggestedLocationId,结果可以直接传入房源搜索接口。
数量随搜索条件变化 每个匹配项的 total 反映所选的 operation(sale 或 rent)和 propertyType,用户在正式搜索之前就能看到各地有多少房源。
地点级别与下钻标志 subTypeText 标注每个匹配项的级别,例如 Municipio、Provincia 或 Distrito,而 divisible 标志说明该地点能否继续拆分成更小的区域。
三个国家站点,同一种调用方式 location 参数可在西班牙(es)、葡萄牙(pt)和意大利(it)之间切换,其他输入参数无需任何改动。
九种房源类别 propertyType 涵盖 homes、newDevelopments、bedrooms、offices、premises、garages、lands、storageRooms 和 buildings,其中 bedrooms 仅限租赁操作。

在线 API 演示

GET /api/project/idealista/get-suggestions

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-suggestions?key=<API_KEY>&location=es&operation=sale&prefix=madrid&propertyType=homes'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

Idealista 地区联想接口会返回什么?

返回一个 JSON 对象,包含 locations 数组和整数 total。在实际检查中,每个 locations 条目包含 name、locationId、divisible、type、suggestedLocationId、subTypeText 以及自己的 total。

哪些参数是必填的?

四个全部必填:location(es、pt 或 it)、operation(sale 或 rent)、prefix(地名文字)和 propertyType(homes、newDevelopments、bedrooms、offices、premises、garages、lands、storageRooms 或 buildings)。

operation 和 propertyType 会改变响应中的什么内容?

它们会改变每条联想结果的 total 字段,该字段统计该交易类型和该房源类型下的房源数量。

可以把 bedrooms 和 sale 一起请求吗?

不可以。接口文档说明 bedrooms 房源类型只能与 rent 操作搭配,所以请将 bedrooms 与 operation=rent 组合使用。

返回的 locationId 怎么用在其他接口里?

把所选匹配项的 locationId 复制到房源接口的 locationId 参数中。例如,针对 madrid 的检查为马德里市镇返回了 0-EU-ES-28-07-001-079,这与整栋建筑房源接口的示例值相同。

能联想出哪些类型的地点?

实际检查返回了名称中包含输入文字的市镇(Municipio)、一个省(Provincia)以及若干区(Distrito),每条都带有 divisible 标志。可能还存在其他地点级别,但没有被观察到。

输入的前缀没有任何匹配时应该怎么处理?

把空的 locations 数组视为没有匹配,让用户重新输入。响应顶层还带有一个整数 total。

相关接口

相关指南

查看订阅方案 →