Documentazione API

Avvio rapido

Crea una API Key dalle impostazioni dell’account, poi inviala come Bearer token. Tutte le route API sono in sola lettura e restituiscono JSON.

Usa /api/v1 per letture in stile REST.
Usa /api/mcp quando colleghi Claude, Cursor o un altro client compatibile con MCP.
period supporta today, yesterday, 7days, 28days, 90days, 180days, 365days e custom_START_END.

Base URL

https://galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Autenticazione

Le API Key vengono create in GA Lite. Conservale lato server e ruotale se vengono esposte.

Header

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

Progetti

Gli endpoint dei progetti restituiscono i siti a cui puoi accedere e le origini dati collegate a ogni progetto.

Elenco progetti

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

Metriche del sito

Gli endpoint delle metriche leggono i dati GA4 per un progetto. Usa force=1 solo per flussi di refresh manuale.

Riepilogo

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

Dati di ricerca

Gli endpoint Search combinano dati Google Search Console e Bing Webmaster. Il parametro sp sceglie all, gsc o bing.

Riepilogo ricerca

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

Funnel

I funnel sono in sola lettura tramite API pubblica. Crea e modifica le definizioni dei funnel nella dashboard.

Elenco funnel

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

Proxy provider raw

Gli endpoint raw proxy servono per compatibilità con formati nativi GA4, GSC o Bing. Preferisci gli endpoint curati salvo quando serve una risposta nativa del provider.

Report GA4 raw

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

I client MCP usano OAuth nel browser per impostazione predefinita. Le API Key restano disponibili come fallback per script e client personalizzati.

Endpoint MCP

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