# Visibility trend for one tracked brand, last 7 days
$ curl "https://api.geogen.io/v1/trends/visibility?entityId=$ENTITY_ID&period=7d" \
-H "Authorization: Bearer $GEOGEN_API_KEY" {
"success": true,
"data": [
{ "date": "2026-10-05", "score": 71.2 },
{ "date": "2026-10-06", "score": 73.9 },
{ "date": "2026-10-07", "score": 78.4 }
]
} import os, requests
r = requests.get(
"https://api.geogen.io/v1/competitors",
params={"entityId": os.environ["ENTITY_ID"]},
headers={"Authorization": f"Bearer {os.environ['GEOGEN_API_KEY']}"},
)
for row in r.json()["data"]:
print(row["rank"], row["name"], row["visibility"]) $ npm install -g @geogenio/cli
$ geogen login
$ geogen competitors --entity $ENTITY_ID --json | jq '.[0]' 你可以查询什么
-
实体与提示词
创建并管理被追踪的品牌,以及针对它们运行的提示词。
- GET/entities
- POST/entities
- PATCH/entities
- GET/entities/check-domain
- GET/entities/prompts
- POST/entities/addprompt
- PATCH/entities/updateprompt
- DELETE/entities/deleteprompt
-
可见度与趋势
按品牌提供每日可见度、情感倾向和引用趋势,可按模型、标签和提示词筛选。
- GET/trends/visibility
- GET/trends/sentiment
- GET/trends/citations
- GET/entities/tracking-status
-
回答
每条 AI 回答及其提及状态,外加完整详情:提及、引用和查询扩展。
- GET/responses
- GET/responses/details
-
引用与查询扩展
AI 引用的域名和 URL,以及它在回答时执行的网络搜索。
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
-
竞争对手
声量份额排行榜:每个品牌的可见度、提及次数、平均位置和情感倾向。
- GET/competitors
-
行动与工作区
AI 生成的建议、任务看板、模型、成员、标签和域名分组。
- GET/entities/actions
- POST/entities/actions/update-status
- GET/models
- GET/workspace
- GET/domain-groups
按基础设施的标准打造
API 目前处于测试阶段:接口可能调整,变更会在更新日志中公布。
- 基础 URL
- https://api.geogen.io/v1
- 认证
- 工作区密钥(wsk_…),通过 Authorization: Bearer 或 X-API-Key 传递
- 格式
- JSON,使用 total / limit / offset 分页
- 速率限制
- 每个密钥每分钟 100 次读取和 20 次写入;可按需提高
- 数据新鲜度
- 每条提示词每日重新运行;可轮询 /entities/tracking-status 获知新数据
- 规范
- OpenAPI 3,位于 docs.geogen.io/openapi.json
团队用它来构建什么
平台与主机服务商
在你的控制面板或 SaaS 中,向客户展示 AI 引擎如何看待他们的网站。
代理商
为客户看板和月度报告提供可见度、引用和竞争对手数据。
SEO 工具厂商
无需自建回答抓取流程,就能增加 AI 可见度模块。
数据与 BI 团队
定时把数据拉入数据仓库,并与流量和收入数据关联。
常见问题
什么是 AI 可见度 API?
AI 可见度 API 返回结构化数据,描述 AI 助手如何回答某个市场的问题:提到了哪些品牌、位置和语气如何、引用了哪些来源、执行了哪些搜索。GeoGen 的 API 提供 15 个引擎的这些数据,每日刷新。
API 覆盖哪些引擎?
与应用相同的 15 个引擎:按用户所见读取的 ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Perplexity, Microsoft Copilot, Mistral, Brave Leo, Claude Haiku,以及直接调用模型的 DeepSeek, MiMo, Grok, Qwen, Claude Sonnet, Claude Opus。GET /models 会列出它们。
如何认证?
在应用中创建工作区 API 密钥(设置 → 工作区 → 你的工作区 → API 密钥),并以 Authorization: Bearer wsk_… 或 X-API-Key 请求头发送。请把密钥保存在服务端。
数据有多新?
套餐内每个引擎上的每条提示词每天都会运行。轮询 GET /entities/tracking-status,即可知道最近一次检查何时完成、下一次何时开始。
有官方的 Google AI 概览 API 吗?
Google 没有为 AI 概览的回答提供公开 API。GeoGen 按用户所见读取 AI 概览和 AI Mode,并通过自己的 API 返回结果:提及、位置和引用来源。
可以转售数据或把它嵌入我的产品吗?
可以,需签订合作协议。平台和 SEO 工具厂商会把 GeoGen 数据嵌入自己的产品;关于规模和再分发条款,请联系合作团队。