Documentation API

Démarrage rapide

Créez une API Key dans les paramètres du compte, puis envoyez-la comme Bearer token. Toutes les routes API sont en lecture seule et renvoient du JSON.

Utilisez /api/v1 pour les lectures de style REST.
Utilisez /api/mcp pour connecter Claude, Cursor ou un autre client compatible MCP.
period prend en charge today, yesterday, 7days, 28days, 90days, 180days, 365days et custom_START_END.

Base URL

https://galite.io/api/v1

En-tête

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Authentification

Les API Keys sont créées dans GA Lite. Conservez-les côté serveur et faites-les tourner si elles sont exposées.

En-tête

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

Projets

Les endpoints de projets renvoient les sites auxquels vous avez accès et les sources de données connectées à chaque projet.

Lister les projets

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

Métriques du site

Les endpoints de métriques lisent les données GA4 d’un projet. Utilisez force=1 uniquement pour les rafraîchissements manuels.

Résumé

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

Données de recherche

Les endpoints Search combinent les données Google Search Console et Bing Webmaster. Le paramètre sp choisit all, gsc ou bing.

Résumé Search

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

Les funnels sont en lecture seule via l’API publique. Créez et modifiez les définitions de funnel dans le tableau de bord.

Lister les funnels

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

Proxy provider brut

Les endpoints raw proxy servent à la compatibilité avec les formats de requête natifs GA4, GSC ou Bing. Préférez les endpoints structurés sauf si une réponse native du provider est nécessaire.

Rapport GA4 brut

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

Les clients MCP utilisent OAuth dans le navigateur par défaut. Les API Keys restent disponibles comme secours pour les scripts et clients personnalisés.

Endpoint MCP

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