按房源 ID 获取 Idealista 房产详情

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

API 功能

按广告 ID 查询单条房源 传入一个数字形式的 propertyId,就能以 JSON 对象的形式得到完整的 Idealista 广告。同一个 ID 会以 adid 返回,所以无需额外映射,就能把结果作为键来缓存和去重。
照片、视频与 3D 看房 multimedia 对象列出每张图片的 url、tag、本地化名称、宽度和高度,随后是 videos 和 virtual3DTours,还有一个标志指明门户自己是否制作了其中的媒体。
坐标与行政区层级 ubication 对象带有 latitude、longitude、locationId、locationName 和四级行政区划,还有 hasHiddenAddress 标志,足以把房源标在地图上,或与区域数据集关联。
降价与能效评级数据 可读取当前价格和带货币后缀的 priceInfo amount,包含数值、百分比与日期的 priceDropInfo 块,以及带有能耗和排放条目的 energyCertification 块。
房间、面积与设施标志 moreCharacteristics 提供 roomNumber、bathNumber、constructedArea、floor,以及 lift、garden、swimmingPool、exterior 等布尔设施标志,可直接用于筛选或对比表格。
发布方类型与最近变更日期 contactInfo 显示广告来自专业中介还是个人发布方,中介还会带有 commercialName 和 micrositeShortName,而 modificationDate 以纪元数值和显示文本给出最近一次变更。
九种语言的广告文本 language 参数为广告文本选择 en、es、it、pt、ca、de、fr、nl 或 nb;comments 数组会标出每一条的语言以及是否为自动翻译。

在线 API 演示

GET /api/project/idealista/property-details

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/property-details?key=<API_KEY>&language=en&location=es&propertyId=112272495'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

房产详情接口返回什么?

它返回一个描述单条 Idealista 广告的 JSON 对象。在对西班牙一条出售房源的实际探测中,该对象包含 adid、price、priceInfo、operation、propertyType、homeType、state、multimedia、ubication、moreCharacteristics、energyCertification、contactInfo、detailWebLink 和 modificationDate 等字段。没有已发布的响应示例,因此其他房源可能有所不同。

propertyId 从哪里获得?

propertyId 是房源的数字广告 ID,通常就是房源网页地址中的那串数字,响应会把它重复为 adid。本项目的房源搜索接口是批量收集 ID 的自然入口。示例值 112272495 是探测所用的房源。

location 和 language 接受哪些值?

location 接受 es、pt 或 it,分别对应西班牙、葡萄牙和意大利市场。language 接受 en、es、it、pt、ca、de、fr、nl 或 nb,用来设置广告文本语言。两者都是必填项。探测使用的是 location es 与 language en,响应中的 country 为 es。

响应包含坐标和照片吗?

包含。在探测中,ubication 带有 latitude 和 longitude,以及 locationId、locationName 和 1 到 4 级行政区划;multimedia 带有含 url、宽度和高度的图片,以及 videos 和 virtual3DTours。响应还会返回 hasHiddenAddress 标志,因此在把位置当作确切地址之前,请先检查它。

modificationDate 是什么意思?可以把它当作房源挂牌时长吗?

modificationDate 返回的是带有数值 value 和显示文本 text 的对象,moreCharacteristics 中也重复了该数值。它标记的是广告最近一次变更的时间,而不是首次发布的日期,所以适合做新鲜度检查,只有长期保存快照时才能大致估算在市天数。

是否包含发布方联系信息?应该保存吗?

contactInfo 返回了 commercialName、userType、micrositeShortName、professional 和联系方式等发布方字段。可以用 userType 和 professional 区分中介与个人卖家;除非你有合法的处理依据,否则请不要在长期数据集中保留个人联系信息。

怎样判断房源是否仍然在售?

探测到的房源 state 为 active,operation 为 sale。只探测了成功的查询,所以已下架或过期广告的行为没有验证。请在每次响应中读取 state 字段,并在自己的代码中处理非 200 的结果。

相关接口

相关指南

查看订阅方案 →