列出 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>µsiteShortName=<micrositeShortName>&operation=<operation>'
查询结果
使用场景
- 在选择某个中介进行合作、转介绍或销售拜访之前,先绘制出它的业务覆盖版图。
- 做竞争对手区域分析,找出竞争中介实际在哪些市镇挂牌。
- 挑选正确的 locationId,之后与 micrositeShortName 组合,查询该中介的房源。
- 为搬迁礼宾服务搭建中介匹配功能,把客户的目的地城市与在当地活跃的中介对应起来。
- 每周保存一次中介的地区列表并做对比,及时发现它向新区域的扩张。
常见问题
如何找到某个中介的 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 这个值。
它和微站点资料接口有什么区别?
本接口回答的是中介在哪些地区有房源。资料接口回答的是中介是谁:商业名称、网站、联系信息、服务语言和品牌图片。