APIドキュメント

クイックスタート

アカウント設定で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 Keysは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}

サイト指標

指標エンドポイントは1つのプロジェクトの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

Raw provider proxy

Raw proxyエンドポイントは、GA4、GSC、Bingのネイティブなリクエスト形式との互換性のためにあります。providerネイティブのレスポンスが必要な場合を除き、整理済みエンドポイントを推奨します。

Raw 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 Keysはスクリプトやカスタムクライアント向けのフォールバックとして利用できます。

MCPエンドポイント

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