获取 Idealista 中介微站点资料:名称、网站、联系信息与服务语言

查看 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)。资料中不包含该中介的房源列表。

API 功能

中介身份字段 返回 shortName、commercialName、slogan、activeSinceYear 和 commercialDataId,一次调用就能得到一条稳定的中介身份记录。
联系方式与地址信息 contactInfo 对象包含多种格式的电话号码、showContactButton 标志、proAgent 标志,以及含街道、地区、邮编和坐标的地址。
中介服务的语言 languages 数组列出该中介提供的服务语言,方便你为说英语或其他非西班牙语的客户筛选中介。
品牌图片 multimedias 对象返回 mainImage 和 brandingLogo,足以渲染中介卡片或目录页,无需另外抓取主页。
聊天与线索标志 hasChatEnabled 和 micrositeLeadAllowed 是布尔值,显示该中介是否通过微站点接受在线聊天和线索咨询。
默认主营提示 defaultTypology 和 defaultOperation 反映中介主要推广的房源与交易类型,是按专长细分中介的有用信号。

在线 API 演示

GET /api/project/idealista/get-microsite-profile

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

查看价格

API 响应 (JSON)

{}
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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

micrositeShortName 从哪里获得?

它是中介专业主页地址里 /pro/ 后面的标识。文档示例和默认值是 jaime-valcarce-consulting-inmobiliario。微站点地区接口使用同一个标识。

location 参数应该填什么?

填 es、pt 和 it 中的国家代码。文档默认值是逗号分隔的 es,pt,it,已记录的探测只使用了 es。

资料响应包含哪些字段?

已记录的探测返回了 shortName、activeSinceYear、commercialName、agencyWebUrl、slogan、defaultTypology、defaultOperation、contactInfo、multimedias、total、languages、commercialDataId、hasChatEnabled、micrositeLeadAllowed 和 corporatePhrase。整数字段 total 的含义文档中没有说明。

contactInfo 里面有什么?

在探测中它包含 phone、contactPhone 对象(phoneNumber、formattedPhone、prefix、phoneNumberForMobileDialing、nationalNumber、formattedPhoneWithPrefix)、showContactButton、proAgent,以及含 streetName、streetNumber、locationName、postalCode、latitude 和 longitude 的 address 对象。

能看出某个中介是否提供聊天服务吗?

可以。hasChatEnabled 布尔值表示该微站点是否启用聊天,micrositeLeadAllowed 则表示是否允许线索咨询。

这个接口会返回中介的房源吗?

不会。它只返回资料。要查看中介在哪些地区有房源,请用微站点地区接口;要取得房源,请使用本 API 的房源接口。

相关接口

相关指南

查看订阅方案 →