监测结果概览
GET/openapi/v1/geo/brands/{brand_id}/overview
需要权限：geo:read
品牌的 GEO 核心指标：提及率、首推率、前三率、口碑正向率与综合分，外加可见度趋势、各平台表现、竞品对比、声量份额和规则化预警。
按时间窗聚合全部轮次，不是只看最近一轮
刚跑完一轮就查，看到的是「含这一轮在内」的累积结果。想看单轮明细用「监测进度」。
请求参数
路径参数
| 参数 | 类型 | 说明 | |
|---|---|---|---|
| brand_id | string | 品牌 ID |
响应
下列字段位于 data 之下。
| 字段 | 类型 | 说明 |
|---|---|---|
| kpi.mentionRate | number | 提及率 % |
| kpi.firstRecRate | number | 首推率 % |
| kpi.top3Rate | number | 前三率 % |
| kpi.positiveRate | number | 口碑正向率 % |
| kpi.healthScore | number | GEO 综合分 0–100 |
| kpi.healthParts | object[] | 综合分的加权构成，逐项给出权重与贡献值 |
| kpi.sampleSize | integer | 样本量。首轮 n=1 时所有比率非 0 即 100，解读时要看它 |
| trend | object[] | 可见度趋势，逐日 |
| platforms | object[] | 各平台可见度 |
| competitors | object[] | 竞品提及率对比 |
| alerts | object[] | 规则化预警（平台下滑 / 口碑转弱 / 竞品反超） |
可能的错误
| code | HTTP | 含义与处置 |
|---|---|---|
| 3001 | 404 | 品牌不存在，或不属于你 |