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