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'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/idealista/get-suggestions",
params={
"key": "<API_KEY>",
"location": "es",
"operation": "sale",
"prefix": "madrid",
"propertyType": "homes",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/idealista/get-suggestions");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"location": "es",
"operation": "sale",
"prefix": "madrid",
"propertyType": "homes",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());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 传给房源接口。
地点与下级区域
/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 |
调用成本暂不可用,未假定任何价格。
中介店铺页
/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 |
调用成本暂不可用,未假定任何价格。
/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 |
调用成本暂不可用,未假定任何价格。
地名联想查询
/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 |
调用成本暂不可用,未假定任何价格。
整栋楼宇搜索
/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 |
调用成本暂不可用,未假定任何价格。
商业地产搜索
/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 |
调用成本暂不可用,未假定任何价格。
住宅房源搜索
/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 |
调用成本暂不可用,未假定任何价格。
房源列表
/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 |
调用成本暂不可用,未假定任何价格。
/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 |
调用成本暂不可用,未假定任何价格。
/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 |
调用成本暂不可用,未假定任何价格。
/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 |
调用成本暂不可用,未假定任何价格。
新开发楼盘单元
/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 |
调用成本暂不可用,未假定任何价格。
房源详情
/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 |
调用成本暂不可用,未假定任何价格。
地点、房源与详情数据能力
通过一套 JSON 接口查询 Idealista 房源。Idealista 是西班牙、葡萄牙和意大利的主流房产门户,无需自建爬虫,就能把地名解析为地点标识,用数十个可选条件搜索出售与出租住宅,并获取单个房源的完整详情。
- 地点查询:地名联想得到 locationId,并逐级下钻到区县与街区,附带各地区房源总数
- 住宅搜索:按价格、面积、卧室、浴室、是否带家具、允许宠物、泳池、露台、电梯等条件筛选出售与出租房源
- 新房与楼盘:新开发项目搜索,以及单个楼盘下的各个单元
- 商业与土地:商铺、办公室、整栋楼宇、土地和储藏室,支持价格与面积筛选
- 房源详情:按房源 ID 获取照片、坐标、价格、联系方类型和修改日期
- 中介店铺页:查询中介资料及其房源所在地区,也可在列表搜索中限定单个中介
接口采用分页的 RESTful JSON 格式,适合房产科技应用、租金与收益分析、竞品监测、选址研究和新房源提醒机器人。