发起 GEO 监测
POST/openapi/v1/geo/runs
需要权限：geo:run
对品牌已启用的意图词，在指定的 AI 平台上各跑一轮监测。接口立即返回，一轮实际要几分钟到几十分钟，用「监测进度」轮询。
前置条件：这个品牌要有已启用的意图词
检测跑的是「已启用的意图词 × 选中的平台」。一条都没启用时返回
3004。第一次接入请看「快速开始」，从建品牌到读结果五步走完。请求参数
Body 参数
| 参数 | 类型 | 说明 | |
|---|---|---|---|
| brand_id | string | 品牌 ID | 必填 |
| platforms | string[] | 要监测的平台，可选 doubao deepseek yuanbao qianwen wenxin kimi。不传 = 套餐允许的全部平台；超出套餐档位的会被忽略而不是报错 |
响应
下列字段位于 data 之下。
| 字段 | 类型 | 说明 |
|---|---|---|
| run_id | string | 本轮检测 ID，用它查进度 |
| status | string | running 已开跑；queued 已受理、在排队 —— 这不是失败，资源就绪后自动跑，不要重试 |
| queue_position | integer | 排队位置，queued 时有 |
可能的错误
| code | HTTP | 含义与处置 |
|---|---|---|
| 1002 | 403 | Key 缺少 geo:run 权限，需重新创建一把 |
| 1003 | 403 | 订阅已过期。读接口不受影响 |
| 2002 | 429 | 当日检测次数用尽，等到明天 |
| 2003 | 429 | 距上次检测间隔太近，按提示的时间点再试 |
| 3003 | 409 | 该品牌已有一轮在跑，等它结束 |
| 3004 | 400 | 没有启用的意图词，或没选到可用平台 |
| 5001 | 503 | 检测资源暂时不可用，可以重试 |