按房源 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为已保存的候选房源补充来自 multimedia 的照片和来自 ubication 的坐标,让每一套都能在地图视图中标出。
- 在发送价格或可售提醒之前,重新获取房源并对比 modificationDate,避免把过期广告推送给用户。
- 传入对应的 language 值,用访客自己的语言驱动租房或买房应用的详情页。
- 把 adid 当作每条 Idealista 广告的标准键,对来自多个数据源的房源去重。
- 利用 contactInfo 中的发布方类型区分中介广告与个人卖家,同时不在存储的数据集中保留个人联系信息。
- 定期保存 modificationDate 快照来估算房源挂牌时长,但要记住它标记的是最近一次变更而不是发布日期。
常见问题
房产详情接口返回什么?
它返回一个描述单条 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 的结果。