GA Lite

开发者

API 文档

使用 GA Lite API 从脚本、应用或 AI 客户端统一读取 Google Analytics 4(GA4)、Google Search Console(GSC)和 Bing Webmaster Tools 数据。

快速开始

在账号设置中创建 API Key,然后以 Bearer token 方式发送。所有 API 路由都是只读接口,返回 JSON。

  • 读取 REST 风格数据时使用 /api/v1。
  • 连接 Claude、Cursor 或其它支持 MCP 的客户端时使用 /api/mcp。
  • period 支持 today、yesterday、7days、28days、90days、180days、365days 和 custom_START_END。

Base URL

https://galite.io/api/v1

请求头

Authorization: Bearer sk_live_xxxxxxxxxxxxx

认证

API Key 在 GA Lite 内创建。请只在服务端保存;如果泄露,立即删除并重新生成。

请求头

curl https://galite.io/api/v1/projects/list \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"

项目

项目接口返回你可访问的网站,以及每个项目已连接的数据源。

项目列表

GET https://galite.io/api/v1/projects/list
GET https://galite.io/api/v1/projects/{projectKey}

站点指标

指标接口读取单个项目的 GA4 数据。只有手动刷新场景才建议使用 force=1。

摘要指标

GET https://galite.io/api/v1/metrics/{projectKey}/summary?period=28days
GET https://galite.io/api/v1/metrics/{projectKey}/timeseries?period=28days&metric=screenPageViews
GET https://galite.io/api/v1/metrics/{projectKey}/dimension?dimension=country&period=28days
GET https://galite.io/api/v1/metrics/{projectKey}/realtime

搜索数据

Search 接口聚合 Google Search Console 与 Bing Webmaster 数据。sp 参数可选择 all、gsc 或 bing。

搜索摘要

GET https://galite.io/api/v1/metrics/{projectKey}/search/summary?period=28days&sp=all
GET https://galite.io/api/v1/metrics/{projectKey}/search/timeseries?period=28days&sp=gsc
GET https://galite.io/api/v1/metrics/{projectKey}/search/dimension?dimension=query&period=28days&sp=bing

漏斗

公开 API 只读返回漏斗数据。漏斗的创建和编辑请在控制台完成。

漏斗列表

GET https://galite.io/api/v1/projects/{projectKey}/funnels/list
GET https://galite.io/api/v1/funnels/{funnelKey}/results?period=28days

原生 Provider 代理

Raw proxy 用于兼容 GA4、GSC 或 Bing 的原生请求形状。除非需要 provider 原生响应,默认优先使用上面的整理后接口。

原生 GA4 报告

POST https://galite.io/api/v1/raw/ga4/proxy

{
  "project_key": "PROJECT_KEY",
  "path": "properties/PROPERTY_ID:runReport",
  "body": {
    "dateRanges": [{ "startDate": "28daysAgo", "endDate": "today" }],
    "metrics": [{ "name": "screenPageViews" }]
  }
}

MCP 端点

MCP 客户端默认走浏览器 OAuth 授权。API Key 仍可作为脚本或自定义客户端的兜底方式。

MCP 端点

POST https://galite.io/api/mcp