API-Dokumentation

Schnellstart

Erstelle in den Kontoeinstellungen einen API Key und sende ihn als Bearer token. Alle API-Routen sind read-only und geben JSON zurück.

Verwende /api/v1 für REST-Abfragen.
Verwende /api/mcp, wenn du Claude, Cursor oder einen anderen MCP-fähigen Client verbindest.
period unterstützt today, yesterday, 7days, 28days, 90days, 180days, 365days und custom_START_END.

Base URL

https://galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Authentifizierung

API Keys werden in GA Lite erstellt. Bewahre sie serverseitig auf und rotiere sie, falls sie offengelegt wurden.

Header

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

Projekte

Projekt-Endpunkte geben die Websites zurück, auf die du Zugriff hast, sowie die Datenquellen, die mit jedem Projekt verbunden sind.

Projekte auflisten

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

Website-Metriken

Metrik-Endpunkte lesen GA4-Daten für ein Projekt. Nutze force=1 nur für manuelle Aktualisierungen.

Übersicht

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

Suchdaten

Search-Endpunkte kombinieren Daten aus Google Search Console und Bing Webmaster. Der Parameter sp wählt all, gsc oder bing.

Suchübersicht

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

Funnels

Funnels sind über die öffentliche API read-only. Erstelle und bearbeite Funnel-Definitionen im Dashboard.

Funnels auflisten

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-Endpunkte dienen der Kompatibilität mit nativen GA4-, GSC- oder Bing-Request-Formaten. Nutze bevorzugt die kuratierten Endpunkte, außer du brauchst eine provider-native Antwort.

Raw-GA4-Bericht

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-Endpunkt

MCP-Clients verwenden standardmäßig Browser-OAuth. API Keys bleiben als Fallback für Skripte und eigene Clients verfügbar.

MCP-Endpunkt

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