GA Lite

Ontwikkelaars

API-documentatie

Gebruik de GA Lite API om Google Analytics 4 (GA4), Google Search Console (GSC) en Bing Webmaster Tools te lezen vanuit scripts, apps of AI-clients.

Snel starten

Maak een API-sleutel in je accountinstellingen en verstuur deze als Bearer-token. API-antwoorden gebruiken JSON.

  • Gebruik /api/v1 voor REST-achtige reads.
  • Gebruik /api/mcp wanneer je Claude, Cursor of een andere MCP-client koppelt.
  • period ondersteunt today, yesterday, 7days, 28days, 90days, 180days, 365days en custom_START_END.

Basis-URL

https://app.galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Authenticatie

API Keys worden in GA Lite aangemaakt. Bewaar ze server-side en roteer ze als ze zijn gelekt.

Header

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

Projecten

Project-endpoints geven de sites terug waartoe je toegang hebt en de databronnen die aan elk project zijn gekoppeld.

Projecten weergeven

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

Sitemetrics

Metric-endpoints lezen GA4-data voor één project. Gebruik force=1 alleen voor handmatige refreshflows.

Samenvatting

GET https://app.galite.io/api/v1/metrics/{projectKey}/summary?period=28days
GET https://app.galite.io/api/v1/metrics/{projectKey}/timeseries?period=28days&metric=screenPageViews
GET https://app.galite.io/api/v1/metrics/{projectKey}/dimension?dimension=country&period=28days
GET https://app.galite.io/api/v1/metrics/{projectKey}/realtime

Zoekdata

Search-endpoints combineren Google Search Console- en Bing Webmaster-data. De parameter sp kiest all, gsc of bing.

Zoeksamenvatting

GET https://app.galite.io/api/v1/metrics/{projectKey}/search/summary?period=28days&sp=all
GET https://app.galite.io/api/v1/metrics/{projectKey}/search/timeseries?period=28days&sp=gsc
GET https://app.galite.io/api/v1/metrics/{projectKey}/search/dimension?dimension=query&period=28days&sp=bing

Funnels

Funnels zijn via de publieke API alleen te lezen. MCP kan geregistreerde gebeurtenissen en pagina’s controleren en na je uitdrukkelijke bevestiging een funnel maken. Je kunt funneldefinities nog steeds in het dashboard maken en bewerken.

Funnels weergeven

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

Raw provider proxy

Raw proxy-endpoints zijn bedoeld voor compatibiliteit met native GA4-, GSC- of Bing-requestvormen. Gebruik bij voorkeur de samengestelde endpoints, tenzij je een provider-native response nodig hebt.

Raw GA4-rapport

POST https://app.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-clients gebruiken standaard browser-OAuth. API Keys blijven beschikbaar als fallback voor scripts en custom clients.

MCP-endpoint

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