Visible API：将GEO数据集成到您的技术栈
介绍
Visible API提供对所有AI发现数据的程序化访问——评分、提及率、引用率、提示词级别结果和竞争对手基准。它使团队能够将GEO情报集成到现有的仪表板、BI工具、CRM工作流和营销自动化系统中。
本指南涵盖API认证、核心端点、数据结构，以及针对最常见使用场景的实用集成模式。
核心概念
API密钥认证：所有Visible API请求都需要有效的API密钥，密钥的作用域限定在您的工作台和计划层级内。
速率限制：API调用按计划层级进行速率限制。入门版：每天100次请求；商业版：每天1,000次请求；企业版：自定义限制。
数据新鲜度：API数据反映最近完成的扫描，按您的扫描节奏更新（商业版每日，入门版每周）。
分页：所有列表端点支持基于游标的分页，默认页面大小为50条结果。
Webhook支持：Visible支持扫描完成事件的Webhook，允许您的系统在扫描完成时自动拉取最新数据。
为何重要
锁定在Visible仪表板内的GEO数据，对需要将AI可见度指标纳入更广泛报告工作流的团队造成摩擦。Visible API支持：将GEO与SEO和付费指标并列展示的统一营销仪表板；当AI Discovery评分低于阈值时的自动告警；用AI可见度数据丰富潜在客户的CRM信息；以及包含GEO KPI的高管报告与收入指标并列展示。
分步指导
第一步——获取您的API密钥 在Visible中导航到设置 > API访问。生成API密钥。安全存储——只显示一次。
第二步——认证请求
所有请求使用Bearer令牌认证：
curl -H "Authorization: Bearer 您的API密钥" https://api.visible.spotlize.com/v1/scores
第三步——核心端点
| 端点 | 方法 | 描述 |
|---|---|---|
/v1/scores |
GET | 按品牌获取当前AI Discovery评分 |
/v1/scores/history |
GET | 带日期范围过滤的评分历史 |
/v1/prompts |
GET | 最新扫描的提示词级别结果 |
/v1/competitors |
GET | 竞争对手基准数据 |
/v1/engines |
GET | 引擎分解评分 |
/v1/citations |
GET | 引用来源数据 |
/v1/scans |
GET | 扫描历史和状态 |
/v1/scans/trigger |
POST | 触发手动扫描 |
第四步——配置用于自动化数据拉取的Webhook
在设置 > Webhook中添加您的端点URL，Visible将POST扫描完成事件。
第五步——构建您的集成
常见集成模式： - Looker/Tableau/Power BI：通过定期API调用拉取评分；将GEO指标与SEO和付费数据并列构建 - Slack告警：当评分变化超过5分时Webhook触发Slack通知 - HubSpot丰富：将AI可见度评分附加到公司记录作为销售背景 - 每周高管报告：通过Zapier或Make实现自动化评分拉取 + 格式化邮件发送
最佳实践
- 缓存API响应：评分数据按扫描节奏更新，每次页面加载都调用API是不必要的，会耗尽速率限制。
- 使用Webhook而非轮询：对实时工作流而言，Webhook触发的拉取比定期轮询更高效。
- 版本化您的集成：Visible API使用版本化端点（/v1/），监测变更日志了解新版本。
常见错误
- 在客户端代码中暴露API密钥：API密钥必须保存在服务端，永远不要在前端JavaScript中包含它们。
- 忽视速率限制：超过速率限制会导致429错误，在集成中实施指数退避。
- 基于不稳定的端点构建：只使用稳定的版本化端点，测试版端点可能在没有通知的情况下更改。
相关文章
总结
Visible API提供对所有GEO情报数据的程序化访问。使用API密钥认证，使用评分和提示词数据的核心端点，配置Webhook实现自动化工作流，并构建将GEO指标嵌入现有报告体系的集成。保持API密钥在服务端，缓存响应，并使用Webhook而非轮询。