Dokumentacja API · GA Lite

Szybki start

Utwórz API Key w ustawieniach konta i wysyłaj go jako Bearer token. Wszystkie trasy API są tylko do odczytu i zwracają JSON.

Używaj /api/v1 do odczytów w stylu REST.
Używaj /api/mcp przy podłączaniu Claude, Cursor lub innego klienta MCP.
period obsługuje today, yesterday, 7days, 28days, 90days, 180days, 365days i custom_START_END.

Base URL

https://galite.io/api/v1

Nagłówek

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Uwierzytelnianie

API Keys tworzy się w GA Lite. Przechowuj je po stronie serwera i rotuj, jeśli zostaną ujawnione.

Nagłówek

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

Projekty

Endpointy projektów zwracają witryny, do których masz dostęp, oraz źródła danych podłączone do każdego projektu.

Lista projektów

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

Metryki witryny

Endpointy metryk odczytują dane GA4 dla jednego projektu. Używaj force=1 tylko w ręcznych odświeżeniach.

Podsumowanie

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

Dane wyszukiwania

Endpointy Search łączą dane Google Search Console i Bing Webmaster. Parametr sp wybiera all, gsc albo bing.

Podsumowanie wyszukiwania

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

Lejki

Lejki są tylko do odczytu przez publiczne API. Twórz i edytuj definicje lejków w dashboardzie.

Lista lejków

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

Raw provider proxy

Endpointy raw proxy służą zgodności z natywnymi formatami żądań GA4, GSC lub Bing. Preferuj endpointy uporządkowane, chyba że potrzebujesz natywnej odpowiedzi providera.

Raw raport 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" }]
  }
}

Endpoint MCP

Klienci MCP domyślnie używają OAuth w przeglądarce. API Keys pozostają dostępne jako fallback dla skryptów i klientów niestandardowych.

Endpoint MCP

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