GEO 体检仪 API 概述
GEO 体检仪年度套餐（5800 元/年）提供完整 RESTful API，支持企业将 GEO 诊断能力集成到内部系统。参考GEO API百科。
API 接入流程
Step 1: 获取 API Key
- 购买年度套餐（5800 元/年）
- 在控制台「API 管理」页面生成 API Key
- 妥善保管 API Key，不暴露在前端代码中
Step 2: 阅读 API 文档
API 文档包含：
- 接口列表与参数说明
- 请求/响应示例
- 错误码定义
- 限流策略
- SDK 下载（Node.js/Python/Java）
Step 3: 调用诊断接口
核心 API 接口：
| 接口 | 方法 | 功能 |
|---|---|---|
| /api/diagnose/run | POST | 触发诊断（传品牌名+品类词） |
| /api/diagnose/report/:taskId | GET | 查询诊断结果 |
| /api/diagnose/history | GET | 拉取历史诊断数据 |
| /api/diagnose/brands | GET | 查询已诊断品牌列表 |
Step 4: 集成到内部系统
- BI 系统：定时拉取 GEO 数据到数据仓库，参考GEO 看板
- 营销自动化：GEO 指标触发营销流程
- 报警系统：结合 Webhook 实现实时预警
API 调用示例
触发诊断的请求示例：
POST /api/diagnose/run
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"brand": "品牌名",
"category": "品类词",
"competitors": ["竞品1", "竞品2"]
}
API 限流策略
- 默认限流：100 次/分钟，1000 次/天
- 高并发需求可联系商务提升配额
- 超限返回 429 状态码，建议指数退避重试