开发者
企业级开放 API
把 GEO 监测与内容履约能力接入你自己的系统:登记并监测场景问题、取回顺位与引用来源、托管导入文章、获取内容分发渠道。
- 鉴权只需一个请求头 X-API-Key,无需额外换取访问令牌
- 监测为异步任务:发起后即时受理,按任务 ID 轮询取回逐题结果
- 统一响应结构 {code, message, data},数据按租户严格隔离
接入方式
生成 Key,带上请求头即可调用
API Key 在控制台「系统设置 → 开放 API Key」生成,调用时放在请求头中即按该 Key 所属租户身份访问。
- 01
生成 API Key
控制台「系统设置 → 开放 API Key」新建,得到 geo_xxx 明文(仅创建时展示一次);停用后立即失效。
- 02
带上请求头调用
请求头携带 X-API-Key: geo_xxx;请求体为 JSON 时另需 Content-Type: application/json,无需登录态。
- 03
解析统一响应
所有接口返回 { code, message, data }:code 为 200 表示成功,其余按各接口错误码处理。
Key 归属哪个租户,就只能读写该租户下的数据;运营管理接口 /api/v1/admin/** 不接受 API Key,仍要求运营账号登录。
能力概览
开放 API 覆盖的链路
接口清单、参数表与示例代码统一见控制台「帮助文档」,官网不再重复罗列,避免两处口径不一致。
场景问题监测
把场景问题登记为品牌监测词并入队执行,由平台监测服务完成真实 AI 平台联网检索。
- 发起监测:异步受理并返回任务 ID,不阻塞你的调用
- 取回结果:按任务 ID 轮询进度,逐题返回是否被提及、顺位、可见度、平均排名、情感与引用来源
- 管理词条:调整持续监测频率、执行时刻与监测平台,或软删除不再监测的问题(历史记录保留)
内容工厂
外部系统产出的内容可直接托管导入平台内容工厂,统一管理与分享。
- 文章托管导入:支持 Markdown 正文与图片,带外部文章 ID 时按幂等覆盖更新
- 公开预览:为导入的文章生成匿名可访问的预览链接
内容分发
从渠道库挑选投放阵地,再进入发稿流程,费用口径透明。
- 渠道列表:媒体与自媒体渠道,支持行业、平台、粉丝数、收录情况与主办单位等筛选
- 价格透明:只返回发稿费用(人民币元),不含平台采购成本
服务等级
SLA 与套餐配额
服务可用性与场景问题配额按订阅版本划分,企业私有化版本支持定制 SLA 与专属出口。
服务可用性
99.9%
按自然月统计,不含计划内维护窗口
节点延迟参考
- 华东 / 华北30 ~ 70 ms
- 华南 / 华中40 ~ 90 ms
- 西南 / 西北 / 东北50 ~ 120 ms
采样节点全部部署于国内,下表为各地域节点的典型响应延迟区间,实际受网络环境影响。
场景问题上限
| 版本 | 场景问题数量上限 |
|---|---|
| 免费版 | 3 个 |
| 入门版 | 15 个 |
| 基础版 | 50 个 |
| 专业版 | 200 个 |
| 企业私有化 / 旗舰版 | 不限 |
需要联调支持?
企业客户可由技术团队提供接口联调与字段映射说明;也可先申请测试额度自行验证。