AIGEO 开放 API 文档

调用评测 / 内容 / 数据能力，按次计费（1 算力 = 1 元）。在后台「开放 API」签发 Key 后即可调用。

认证

所有接口（除 /info）需携带 API Key：

Authorization: Bearer ag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Key 由后台「开放 API」模块签发，格式 ag_ 前缀，可随时停用/删除。

限流与计费

限流每个 Key 60 秒内最多 10 次请求，超出返回 429（含 Retry-After）
计费首页评测 1 算力/次；整站评测按套餐页数（10/30/100 页）计费
余额不足返回 429，需在「算力中心」充值

接口清单

方法路径说明
POST/open/v1/audit/site提交首页评测，返回六维评分与整改建议
GET/open/v1/audit/site/:domain获取某域名最近评测结果
POST/open/v1/fullsite-audit整站评测（plan_key: basic/pro/enterprise）
GET/open/v1/report/:domain域名最新报告（六维评分）
GET/open/v1/articles洞察文章列表（JSON）
GET/open/v1/leaderboard行业 GEO/SEO 排行榜 Top 50

调用示例

首页评测：

curl -X POST https://geo.heezi.cn/open/v1/audit/site \
  -H "Authorization: Bearer ag_你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"domain":"www.example.com"}'

Python：

import requests
r = requests.post("https://geo.heezi.cn/open/v1/audit/site",
    headers={"Authorization": "Bearer ag_你的密钥"},
    json={"domain": "www.example.com"})
print(r.json())  # {"code":200,"data":{"overall_score":..,"grade":"..","scores":{..}}}

错误码

码含义
400参数错误（缺少 domain 等）
401API Key 无效 / 已停用
404资源不存在（评测记录/文章）
429触发限流，或算力余额不足
500服务内部错误
所有响应统一为 {"code":200,"msg":"...","data":{...}} 结构。