Idealista 房源数据接口:西班牙、葡萄牙与意大利房产搜索 — 打开交互式演示
引导式在线测试。想要原始接口文档? 查看接口文档 & 测试 →
接口列表
每次调用都会自动附带你的 API Key。
/api/project/idealista/get-sublocations 列出 Idealista 可细分地区下的子地区,并附各区域房源总数
说明
返回某个 Idealista 父级地区的下级地区,例如省份下的区县或市镇,方便你从大范围地点逐级下钻到更细的区域。请求时传入国家代码(location:es、pt 或 it)、父级地区 locationId(必须是标记为 divisible=true 的地区,例如 0-EU-ES-28),以及 operation 和 propertyType 筛选条件,它们决定每个子地区总数统计哪些房源。bedrooms 房源类型只能与租赁(rent)操作搭配使用。在已记录的探测请求中(location=es、locationId=0-EU-ES-28、operation=sale、propertyType=homes),接口返回 HTTP 200 和一个 JSON 对象,包含 locations 数组与整数 total;每个 locations 条目带有 name、locationId、divisible、type、suggestedLocationId、subTypeText 以及整数 total。该接口只返回地点和数量,不返回具体房源。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/get-microsite-locations 列出 Idealista 中介微站点有房源的地区
说明
返回某个中介微站点(专业主页)有房源的地点,帮助你了解该中介的业务覆盖范围。用 micrositeShortName 标识中介(即其主页地址中 /pro/ 后面的短名称,例如 sumainmobiliaria),用 location(es、pt 或 it)选择国家,用 locale(es、it、pt、en、ca、de、fr、nl 或 nb)选择响应语言,并提供 locationId(文档示例 0-EU-ES-28)和 operation(文档示例 sale)。五个参数全部必填。该操作没有记录到成功的探测,因此这里无法验证具体的响应字段;文档说明它返回该微站点有房源的地区,在围绕它编写解析器之前,请先在第一次调用时检查实际结构。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/get-microsite-profile 获取 Idealista 中介微站点资料:名称、网站、联系信息与服务语言
说明
返回单个中介微站点的资料,由 micrositeShortName(中介主页地址中 /pro/ 后的短名称)标识,并在 location 指定的国家范围内查找(es、pt、it;文档默认值为 es,pt,it)。在已记录的探测中(location=es、micrositeShortName=jaime-valcarce-consulting-inmobiliario),接口返回 HTTP 200 和一个 JSON 对象,包含 shortName、activeSinceYear、commercialName、agencyWebUrl、slogan、defaultTypology、defaultOperation、contactInfo(电话、含格式化与拨号变体的 contactPhone 对象、showContactButton、proAgent,以及含街道、地区、邮编和坐标的 address 对象)、multimedias(mainImage 与 brandingLogo)、整数 total、languages 数组、commercialDataId、hasChatEnabled、micrositeLeadAllowed,以及 corporatePhrase(text 与 autoTranslated)。资料中不包含该中介的房源列表。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/get-suggestions 把地名自动补全为 Idealista 地区 ID
说明
根据地名的开头几个字,在西班牙、葡萄牙或意大利解析出匹配的 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 参数所需要的标识。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-buildings 按区域、价格和面积搜索 Idealista 整栋建筑房源
说明
返回某个地区的 Idealista 整栋建筑房源分页列表。必填参数为 locale、location(国家站点 es、it 或 pt)、locationId(例如马德里市镇的 0-EU-ES-28-07-001-079)、operation(sale 或 rent)、order(十二种排序方式之一)、maxItems 和 numPage。可选参数用于缩小范围:minPrice 与 maxPrice、minSize 与 maxSize、sinceDate 发布时间窗口(T、Y、W 或 M),以及只保留某个中介建筑房源的 micrositeShortName。该接口目前还没有记录到实际样例或响应示例,因此这里不列出响应字段;映射字段之前,请先检查你自己请求返回的内容。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-commercial-properties 列出出售或出租的商业铺位
说明
返回单个地区的一页 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)。该接口没有附带实际响应样例或响应结构,因此这里无法验证房源字段:映射字段之前请先检查实际响应。多个布尔标志如何组合文档没有说明,请自行测试你所依赖的组合。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-home-properties 列出出售或出租的住宅房源,支持 50 多种筛选条件
说明
返回单个地区的一页 Idealista 住宅房源(购买/租赁 > 住宅)。必填参数:locationId(Idealista 地区 ID,例如 0-EU-ES-28-07-001-079,可通过联想和子地区接口获得)、location(国家站点:es、pt 或 it)、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 限定的中介筛选、面向租赁的 furnished 选项,以及覆盖房源类型、卧室、卫生间、楼宇设施、出售条件和租赁条款的 49 个布尔标志。布尔标志只会以 true 发送;省略某个标志即表示不按它筛选。实际探测中观察到的情况(出售搜索,locale es,location es,maxItems 5,numPage 1,order relevance,无筛选):HTTP 200,JSON 对象包含 elementList(房源卡片)、total、totalPages、actualPage、itemsPerPage、numPaginations、summary、filter、alertName、totalAppliedFilters、searchTitle、geoReach、lowerRangePosition、upperRangePosition 和 paginable。探测到的每张房源卡片都带有 propertyCode、url、price、priceInfo、priceByArea、propertyType、operation、size、rooms、bathrooms、floor、exterior、address、province、municipality、district、neighborhood、locationId、latitude、longitude、numPhotos、thumbnail、multimedia(images、videos、virtual3DTours)、contactInfo(中介名称、用户类型、联系方式、micrositeShortName)、features 对象,以及 priceDropValue 和 priceDropPercentage 等降价字段。该探测没有覆盖租赁搜索、带筛选的搜索、maxItems=0 的计数模式和标志组合,因此它们的行为取自参数说明,在此尚未验证;也没有附带响应结构,映射字段之前请先在实际响应中确认字段是否存在。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-lands 列出 Idealista 出售或出租的土地地块
说明
返回 Idealista 上某一地区出售或出租的土地地块分页列表。必填参数包括国家站点(location:es、it 或 pt)、响应语言(locale)、取自联想或子地区接口的 locationId、交易类型(operation:sale 或 rent)、排序方式、页码(numPage)和每页条数(maxItems)。可选筛选条件包括土地类型(urban 城市用地,buildingLand 可建设地块,nonBuildingLand 不可建设地块)、最低与最高价格、最小与最大地块面积、发布时间窗口(sinceDate:T 为最近 24 小时,仅限租赁;Y 为最近 48 小时,仅限出售;W 为最近一周;M 为最近一个月),以及中介微站点短名称。该接口没有捕获到实际响应,所以其响应字段尚未验证;预计它沿用新房房源接口中看到的分页房源结构(包含房源数组 elementList,以及 total、totalPages 和 actualPage),请在第一次调用时加以确认。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-new-homes 列出 Idealista 出售或出租的新建住宅
说明
列出 Idealista 上某一地区的新建住宅(购买/租赁 > 新房),并支持可选筛选。必填参数包括国家站点(location:es、it 或 pt)、响应语言(locale)、取自联想或子地区接口的 locationId、交易类型(operation:sale 或 rent)、排序方式、页码(numPage)和每页条数(maxItems,最大 40;取 0 只返回房源数量)。可选筛选涵盖已竣工新房、先租后买、政府补贴住房、银行房源、公寓、独栋住宅或别墅、卧室数量(bedrooms0 到 bedrooms4,其中 bedrooms4 表示四间或更多)以及 minPrice 和 maxPrice。在一次观察到的样例调用中(locale=es、location=es、locationId=0-EU-ES-28-07-001-079、operation=sale、order=relevance、maxItems=5),响应是一个 JSON 对象,包含 elementList(房源数组)、total、totalPages、actualPage、itemsPerPage、numPaginations、summary、filter、alertName、totalAppliedFilters、searchTitle、lowerRangePosition、upperRangePosition 和 paginable。每条被观察到的房源都带有 propertyCode、price、priceInfo、propertyType、operation、address、municipality、district、locationId、latitude、longitude、url、description、numPhotos、multimedia、contactInfo、newDevelopmentFinished、isRentToOwn 和 promoName 等字段。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-offices 列出 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),请在第一次调用时加以确认。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-promotion-properties 列出 Idealista 新建楼盘中的住宅或车库单元
说明
列出 Idealista 上某个新建楼盘(开发项目)的各个单元,文档将其描述为全新的住宅或车库。需要四个必填参数,没有分页或筛选参数:国家站点(location:es、pt 或 it)、响应语言(locale)、parentPromotionId(文档说明取自 promotionProperties 中的 promotionId)以及 propertyType(homes 或 garages,文档说明取自 promotionProperties 中的 propertyType)。文档中的示例楼盘 ID 是 104907187。该接口没有捕获到实际响应,所以其响应字段尚未验证。本 API 的新房房源样例中出现了 promoName 字段和新建楼盘标志,但没有专门的楼盘标识字段,因此在串联调用之前,请先在实际响应中确认 promotionProperties 的取值出现在哪里。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/list-storage-rooms 列出 Idealista 出售或出租的储藏室
说明
返回 Idealista 上某一地区出售或出租的储藏室(trasteros)分页列表。必填参数包括国家站点(location:es、it 或 pt)、响应语言(locale)、取自联想或子地区接口的 locationId、交易类型(operation:sale 或 rent)、排序方式、页码(numPage)和每页条数(maxItems)。可选筛选仅限最低与最高价格、最小与最大面积、发布时间窗口(sinceDate:T 为最近 24 小时,仅限租赁;Y 为最近 48 小时,仅限出售;W 为最近一周;M 为最近一个月)以及中介微站点短名称;没有设施标志。该接口没有捕获到实际响应,所以其响应字段尚未验证;预计它沿用本 API 新房房源接口中看到的分页房源结构(包含房源数组 elementList,以及 total、totalPages 和 actualPage),请在第一次调用时加以确认。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/idealista/property-details 按房源 ID 获取 Idealista 房产详情
说明
返回单条 Idealista 房源广告的完整记录,由其数字形式的 propertyId 标识。参数:propertyId(必填,广告 ID,会以 adid 返回)、location(必填,Idealista 市场:es 为西班牙,pt 为葡萄牙,it 为意大利)以及 language(必填,广告文本语言:en、es、it、pt、ca、de、fr、nl 或 nb)。在对一条西班牙出售房源的实际探测中观察到的字段(propertyId 112272495、language en、location es、HTTP 200):adid、price 和 priceInfo(amount、currencySuffix)、operation、propertyType、extendedPropertyType、homeType、state、country、multimedia(带 url、tag、localizedName、宽度和高度的图片,以及 videos、virtual3DTours 和 hasMultimediasMadeByIdealista)、ubication(title、latitude、longitude、hasHiddenAddress、administrativeAreaLevel1 到 4、locationId、locationName)、moreCharacteristics(roomNumber、bathNumber、constructedArea、floor、lift、garden、swimmingPool、exterior、energyPerformance 等)、energyCertification、priceDropInfo、propertyComment 和 comments(含 language 与 autoTranslated 标志)、translatedTexts、suggestedTexts、detailedType、labels、contactInfo(commercialName、userType、micrositeShortName、professional 及相关发布方字段)、detailWebLink、若干 allows* 功能标志、tracking,以及 modificationDate(含 value 和 text 的对象)。该操作没有提供已发布的响应示例,因此这里列出的每个字段都来自那一次探测;其他房源(例如租赁、其他国家或已下架的广告)可能缺少或增加字段。modificationDate 反映的是广告最近一次变更的时间,而不是首次发布时间。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。