OPEN API · V1 · READ ONLY

把 GEO 数据
接入你的业务系统。

引见开放 API 是已采集 GEO 数据的稳定只读出口:用企业熟悉的 Bearer key,读取品牌在 12 个 AI 引擎中的可见度、引用信源与竞品 SoV。

5 分钟开始查看 13 个端点
13 READ-ONLY ENDPOINTS12 AI ENGINES全套餐免费包含
三类核心数据

不是另一个前端,是你数据管道的上游。

01

可见度 Visibility

按天、按引擎读取品牌提及、运行与引用数,以及 prompt × 引擎最新矩阵。

02

引用信源 Citations

按 URL、域名、引擎与时间窗查询 AI 回答的信源,同时获取域名聚合榜单。

03

竞争 SoV

把自家与已配置竞品的声量份额、排名、引擎拆分和落后战场接入报表。

FIRST REQUEST

一个 Bearer key,直接拿 JSON。

以 UTC 毫秒窗口查询可见度。所有响应头都带 X-Request-Id 和限流信息;错误响应体另含 request_id,明细列表用稳定游标分页。

阅读鉴权与密钥管理
bash
curl --get https://api.zhimahang.com/v1/metrics/visibility \
  -H "Authorization: Bearer $YINJEN_API_KEY" \
  --data-urlencode "since=1787558400000" \
  --data-urlencode "until=1788163200000"

从采集结果,到企业的下一个动作。

WAREHOUSE

同步进企业数仓

用游标分页定时拉取运行与引用明细,在 90 天保留期内沉淀企业长期历史。

BI

拼进现有 BI 仪表盘

把可见度与 SoV 按引擎、日期、品牌拆解,与线索、内容发布和销售数据同屏对照。

ALERTING

建立品牌可见度告警

轮询日聚合与用量端点,在提及率下降、竞品超越或调用量接近上限时推送内部告警。

BOUNDARIES

稳定数据出口,边界也写清楚。

01只读已采集数据:不实时询问 AI 引擎,不提交采集任务。
02明细保留 90 天;趋势聚合包含软删历史,可见度矩阵则读取未软删的最新明细。
03不提供 sandbox:免费的只读集成直接使用当前租户数据。
04可见度、SoV、日期桶与空值都有固定口径,对账前请先阅读定义。
START BUILDING

先跑通第一个可见度查询。

在桌面客户端签发密钥,然后按快速开始用 cURL、Python 或 Node.js 拿到本品牌上周的引擎提及分布。

打开快速开始下载桌面客户端