Documentation API

Démarrage rapide

Créez une clé API dans les paramètres de votre compte, puis envoyez-la comme jeton Bearer. Les réponses de l’API sont au format 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.

URL de base

https://app.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://app.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://app.galite.io/api/v1/projects/list
GET https://app.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://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

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://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

Les entonnoirs sont en lecture seule via l’API publique. MCP peut examiner les événements et pages enregistrés, puis créer un entonnoir après votre confirmation explicite. Vous pouvez toujours créer et modifier les définitions d’entonnoir dans le tableau de bord.

Lister les funnels

GET https://app.galite.io/api/v1/projects/{projectKey}/funnels/list
GET https://app.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://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" }]
  }
}

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://app.galite.io/api/mcp