获取 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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µsiteShortName=jaime-valcarce-consulting-inmobiliario'
查询结果
使用场景
- 用 commercialName、agencyWebUrl 和 contactInfo 丰富西班牙中介 CRM,用于开拓联系和去重。
- 检查 languages 数组中是否有英语或中文服务,筛出能服务外籍客户的中介。
- 借助 hasChatEnabled 找出能快速回复在线咨询的中介,再把线索转给它们。
- 为本 API 搜索接口取回的房源关联经过核实的中介身份。
- 利用 multimedias 对象中的名称、标语、地址和品牌图片,生成中介目录页面。
常见问题
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 的房源接口。