GA Lite

Vývojáři

Dokumentace API

Použijte API GA Lite ke čtení dat z Google Analytics 4 (GA4), Google Search Console (GSC) a Bing Webmaster Tools ze skriptů, aplikací nebo AI klientů.

Rychlý start

V nastavení účtu vytvořte API Key a odešlete jej jako Bearer token. Všechny API routy jsou pouze pro čtení a vracejí JSON.

  • Pro REST čtení použijte /api/v1.
  • Pro připojení Claude, Cursor nebo jiného MCP klienta použijte /api/mcp.
  • period podporuje today, yesterday, 7days, 28days, 90days, 180days, 365days a custom_START_END.

Base URL

https://galite.io/api/v1

Hlavička

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Autentizace

API Keys se vytvářejí v GA Lite. Uchovávejte je na serveru a při úniku je vyměňte.

Hlavička

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

Projekty

Projektové endpointy vracejí weby, ke kterým máte přístup, a zdroje dat připojené ke každému projektu.

Vypsat projekty

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

Metriky webu

Endpointy metrik čtou GA4 data pro jeden projekt. force=1 používejte jen pro ruční obnovení.

Souhrn

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

Data z vyhledávání

Search endpointy kombinují data Google Search Console a Bing Webmaster. Parametr sp vybírá all, gsc nebo bing.

Souhrn vyhledávání

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

Funnely

Funnely jsou přes veřejné API pouze pro čtení. Definice funnelů vytvářejte a upravujte v dashboardu.

Vypsat funnely

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 endpointy slouží ke kompatibilitě s nativními tvary požadavků GA4, GSC nebo Bing. Pokud nepotřebujete nativní odpověď provideru, preferujte kurátorované endpointy.

Raw GA4 report

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 endpoint

MCP klienti ve výchozím stavu používají OAuth v prohlížeči. API Keys zůstávají dostupné jako záloha pro skripty a vlastní klienty.

MCP endpoint

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