快速開始
在帳號設定中建立 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
