列出 Idealista 中介微站点有房源的地区

查看 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)。五个参数全部必填。该操作没有记录到成功的探测,因此这里无法验证具体的响应字段;文档说明它返回该微站点有房源的地区,在围绕它编写解析器之前,请先在第一次调用时检查实际结构。

API 功能

中介业务覆盖范围 查看某个中介微站点实际有房源的所有地区,而不是凭中介名称或总部位置去猜测它的业务范围。
按微站点短名称查询 中介通过 micrositeShortName 寻址,也就是主页地址中 /pro/ 后面的短名称,因此无需数字形式的中介 ID,就能查询任何专业主页。
支持九种响应语言 locale 参数接受 es、it、pt、en、ca、de、fr、nl 和 nb,同一个查询可以服务说西班牙语、加泰罗尼亚语、荷兰语或英语的受众。
按交易类型限定的查询 必填的 operation 参数(文档示例为 sale)把查询绑定到某种房源交易类型,这样读到的覆盖范围正是你关心的那类业务。
配合房源搜索使用 中介覆盖的地区会告诉你,在接受 micrositeShortName 的房源接口里应该搭配哪些 locationId,后续搜索就不会浪费在没有房源的区域上。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-microsite-locations?key=<API_KEY>&locale=es&location=es&locationId=<locationId>&micrositeShortName=<micrositeShortName>&operation=<operation>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

如何找到某个中介的 micrositeShortName?

它是中介专业主页地址里 /pro/ 后面的标识。本接口的文档示例是 sumainmobiliaria。本 API 的微站点资料接口使用同一个标识。

哪些参数是必填的?

五个全部必填:locale、location、locationId、micrositeShortName 和 operation。文档示例依次为 es、国家代码(es、pt 或 it)、0-EU-ES-28、sumainmobiliaria 和 sale。

locale 参数有什么作用?

它用来选择语言。文档中的取值有 es、it、pt、en、ca、de、fr、nl 和 nb。

响应包含哪些字段?

文档说明该接口返回微站点有房源的地区。该操作没有记录到成功的探测,所以字段级细节尚未验证;在固定数据结构之前,请先检查第一次的实际响应。

operation 应该填什么值?

文档示例是 sale。本 API 的相关子地区接口统计的是出售和出租房源,所以自然可以再尝试 rent 这个值。

它和微站点资料接口有什么区别?

本接口回答的是中介在哪些地区有房源。资料接口回答的是中介是谁:商业名称、网站、联系信息、服务语言和品牌图片。

相关接口

相关指南

查看订阅方案 →