🏠

Idealista 房源数据接口:西班牙、葡萄牙与意大利房产搜索 APIs

先解析 Idealista 地点标识,再搜索西班牙、葡萄牙和意大利的住宅租售、新房楼盘、商铺、办公室、土地、整栋楼宇与储藏室。独立只读的房源数据接口,用于房产研究,并非 Idealista 官方集成、房源发布服务或成交记录。

打开独立的 Idealista 数据演示

第一个地点联想请求

将 <API_KEY> 替换为你在控制台获得的授权平台 API 密钥。查询链接中包含密钥,请不要放进分享链接、截图、代码仓库或日志,正式调用应放在服务端完成。

示例在西班牙站点对出售住宅做地名联想(location=es、operation=sale、prefix=madrid、propertyType=homes)。已记录的检查结果中,匹配项同时包含市级、省级和各个区,并各自带有 locationId 与房源总数。请按 name 和 subTypeText 选出符合目标的一项,把它的 locationId 原样用于房源搜索。该请求只读取数据,不需要 Idealista 账号凭证,也不保证以后返回相同的匹配项。

基础 URL https://api.opendata-api.com

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 地点与房源请求基础
  • 先用 get-suggestions 解析地名,按 name 和 subTypeText 选出符合目标的条目,并原样传入它的 locationId,例如马德里市是 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 为十二种排序键之一。sinceDate 中,T(最近 24 小时)只适用于出租,Y(最近 48 小时)只适用于出售。furnished 同样是单值选择项而不是布尔值:留空,或传 furnished、furnishedKitchen,并且只能配合 operation=rent。
  • petsAllowed、swimmingPool 等布尔标志传 true 表示启用,不传表示不筛选;参考文档用省略参数来表达 false。这里没有观察到显式传 false 的行为,所以不要用它来请求相反的结果。petsAllowed 等仅限出租的标志需要 operation=rent。多个标志如何组合文档没有说明,依赖某种组合之前请先在自己的搜索里对比总数。
  • numPage 从 1 开始,响应里的 totalPages 是上限。maxItems 默认 30,文档所述最大为 40;已记录的马德里出售搜索使用 maxItems 5,返回 total 19806、共 3962 页,可见每页数量太小会成倍增加页数。仅计数模式(maxItems 0)只是文档所述,尚未验证。每一页都是一次独立的平台请求,遍历大型结果集之前请先规划好页数。

读取房源前先检查业务状态

请把 HTTP 状态与网关的 code/message/data 业务状态分开检查:code 为 200 表示网关业务成功,仅有 HTTP 200 并不够。随后检查接口返回内容,再使用 elementList、locations 或房源字段。房源搜索会返回 total、totalPages 和 totalAppliedFilters;total 为零或列表为空只是需要如实记录的结果,不能证明该地区没有房源,缺失字段表示未知,不等于零。

选择你的 Idealista 数据工作流
把地名转成地点标识

先用 get-suggestions:传入 location(es、pt 或 it)、operation(sale 或 rent)、prefix 和 propertyType,再复制选中条目的 locationId。返回条目会混合市、省和区,每一项都带有按所选交易类型和房产类型统计的总数。只有带 divisible=true 的条目才适合用 get-sublocations 继续下钻到区或市;其 bedrooms 房产类型只能配合 rent 使用。这两个接口只返回地点与数量,不返回房源本身。

搜索出售或出租住宅

list-home-properties 必填 locationId、location、locale、operation、order、maxItems 和 numPage。可选参数包括价格与面积范围、发布时间窗口、中介筛选、出租用的 furnished 选择项,以及 49 个布尔标志。已记录的只有一次无筛选的出售搜索,返回 elementList 以及 total、totalPages、totalAppliedFilters。出租搜索、带筛选的搜索、仅计数模式和标志组合都只是文档所述,尚未验证,使用前请先检查第一次返回内容。

查找新房与楼盘单元

list-new-homes 搜索某个地点的新建住宅,可按公寓、独栋、卧室数量和价格筛选;马德里出售搜索返回的分页结构与住宅搜索相同。list-promotion-properties 列出单个楼盘的各个单元,必填 parentPromotionId 和取自 promotionProperties 的 propertyType(homes 或 garages);它不分页,也没有已记录的返回样例,串联调用前请先在真实列表里确认楼盘标识出现在哪个字段。

搜索商铺、办公室、土地与储藏室

list-commercial-properties、list-offices、list-lands、list-buildings 和 list-storage-rooms 使用与住宅搜索相同的核心参数(locationId、location、locale、operation、order、maxItems、numPage),再加价格、面积和发布时间窗口筛选。商铺另有物业类型和经营业态标志,办公室另有布局与配套标志。这五个接口都没有已记录的返回样例,预计结构类似住宅搜索的分页结果,但映射字段前请先检查第一次返回内容,并使用各接口列出的每页数量。

读取单个房源的完整信息

property-details 必填 propertyId、location 和 language(广告文字语言)。房源卡片里的 propertyCode 就是房源链接中出现的数字编号。已记录的西班牙出售房源返回了价格、交易类型、房产类型、照片、坐标、房屋特征、联系方类型和修改日期。位置信息里带有 hasHiddenAddress 标志,把坐标当作街道地址之前请先检查它。

查询中介店铺页及覆盖地区

get-microsite-profile 需要 micrositeShortName(中介主页地址中 /pro/ 之后的标识)和 location;已记录的资料返回了中介名称、网站、联系方式、语言和地址。get-microsite-locations 必填 micrositeShortName、location、locale、locationId 和 operation,目前没有已记录的返回样例。两者都不返回中介名下的房源;若要把房源搜索限定为某个中介,请把 micrositeShortName 传给房源接口。

地点与下级区域

GET /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。该接口只返回地点和数量,不返回具体房源。

测试此 Idealista 接口 4 个必填 · 0 个可选
参数位置值
query
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-sublocations?key=<API_KEY>&location=es&locationId=<locationId>&operation=sale%2Crent&propertyType=homes%2CnewDevelopments%2Cbedrooms%2Coffices%2Cpremises%2Cgarages%2Clands%2CstorageRooms%2Cbuildings'

中介店铺页

GET /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)。五个参数全部必填。该操作没有记录到成功的探测,因此这里无法验证具体的响应字段;文档说明它返回该微站点有房源的地区,在围绕它编写解析器之前,请先在第一次调用时检查实际结构。

测试此 Idealista 接口 5 个必填 · 0 个可选
参数位置值
query
query
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-microsite-locations?key=<API_KEY>&locale=es&location=es&locationId=<locationId>&micrositeShortName=<micrositeShortName>&operation=<operation>'
GET /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)。资料中不包含该中介的房源列表。

测试此 Idealista 接口 2 个必填 · 0 个可选
参数位置值
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-microsite-profile?key=<API_KEY>&location=es%2Cpt%2Cit&micrositeShortName=jaime-valcarce-consulting-inmobiliario'

地名联想查询

GET /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 参数所需要的标识。

测试此 Idealista 接口 4 个必填 · 0 个可选
参数位置值
query
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-suggestions?key=<API_KEY>&location=es&operation=sale&prefix=madrid&propertyType=homes'
GET /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。该接口目前还没有记录到实际样例或响应示例,因此这里不列出响应字段;映射字段之前,请先检查你自己请求返回的内容。

测试此 Idealista 接口 7 个必填 · 6 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (1)
参数位置值
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-buildings?key=<API_KEY>&locale=es&location=es&locationId=0-EU-ES-28-07-001-079&maxItems=30&numPage=1&operation=sale&order=relevance'
GET /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)。该接口没有附带实际响应样例或响应结构,因此这里无法验证房源字段:映射字段之前请先检查实际响应。多个布尔标志如何组合文档没有说明,请自行测试你所依赖的组合。

测试此 Idealista 接口 7 个必填 · 32 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (25)
参数位置值
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

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

查看价格
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'
GET /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 的计数模式和标志组合,因此它们的行为取自参数说明,在此尚未验证;也没有附带响应结构,映射字段之前请先在实际响应中确认字段是否存在。

测试此 Idealista 接口 7 个必填 · 56 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (47)
参数位置值
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

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-home-properties?key=<API_KEY>&locale=es&location=es&locationId=<locationId>&maxItems=30&numPage=<numPage>&operation=sale&order=relevance'

房源列表

GET /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),请在第一次调用时加以确认。

测试此 Idealista 接口 7 个必填 · 9 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (4)
参数位置值
query
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-lands?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cit%2Cpt&locationId=0-EU-ES-28-07-001-079&maxItems=30%2C40%2C0&numPage=1&operation=sale%2Crent&order=relevance%2Clowestprice%2Chighestprice%2Cmostrecent%2Cleastrecent%2Chighestpricereduction%2Clowestpricem2%2Chighestpricem2%2Cbiggest%2Csmallest%2Chighestfloors%2Clowestfloors'
GET /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 等字段。

测试此 Idealista 接口 7 个必填 · 13 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (7)
参数位置值
query
query
query
query
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-new-homes?key=<API_KEY>&locale=es&location=es&locationId=<locationId>&maxItems=30%2C40&numPage=<numPage>&operation=sale&order=relevance'
GET /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),请在第一次调用时加以确认。

测试此 Idealista 接口 7 个必填 · 18 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (12)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query

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

查看价格
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'
GET /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),请在第一次调用时加以确认。

测试此 Idealista 接口 7 个必填 · 6 个可选
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
可选筛选、排序与发布时间范围 (1)
参数位置值
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-storage-rooms?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cit%2Cpt&locationId=0-EU-ES-28-07-001-079&maxItems=30%2C40%2C0&numPage=1&operation=sale%2Crent&order=relevance%2Clowestprice%2Chighestprice%2Cmostrecent%2Cleastrecent%2Chighestpricereduction%2Clowestpricem2%2Chighestpricem2%2Cbiggest%2Csmallest%2Chighestfloors%2Clowestfloors'

新开发楼盘单元

GET /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 的取值出现在哪里。

测试此 Idealista 接口 4 个必填 · 0 个可选
参数位置值
query
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-promotion-properties?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cpt%2Cit&parentPromotionId=104907187&propertyType=homes%2Cgarages'

房源详情

GET /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 反映的是广告最近一次变更的时间,而不是首次发布时间。

测试此 Idealista 接口 3 个必填 · 0 个可选
参数位置值
query
query
query

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

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/idealista/property-details?key=<API_KEY>&language=en&location=es&propertyId=112272495'

地点、房源与详情数据能力

通过一套 JSON 接口查询 Idealista 房源。Idealista 是西班牙、葡萄牙和意大利的主流房产门户,无需自建爬虫,就能把地名解析为地点标识,用数十个可选条件搜索出售与出租住宅,并获取单个房源的完整详情。

  • 地点查询:地名联想得到 locationId,并逐级下钻到区县与街区,附带各地区房源总数
  • 住宅搜索:按价格、面积、卧室、浴室、是否带家具、允许宠物、泳池、露台、电梯等条件筛选出售与出租房源
  • 新房与楼盘:新开发项目搜索,以及单个楼盘下的各个单元
  • 商业与土地:商铺、办公室、整栋楼宇、土地和储藏室,支持价格与面积筛选
  • 房源详情:按房源 ID 获取照片、坐标、价格、联系方类型和修改日期
  • 中介店铺页:查询中介资料及其房源所在地区,也可在列表搜索中限定单个中介

接口采用分页的 RESTful JSON 格式,适合房产科技应用、租金与收益分析、竞品监测、选址研究和新房源提醒机器人。

相关指南