Documentación API

Inicio rápido

Crea una API Key en la configuración de tu cuenta y envíala como Bearer token. Todas las rutas de la API son de solo lectura y devuelven JSON.

Usa /api/v1 para lecturas de estilo REST.
Usa /api/mcp al conectar Claude, Cursor u otro cliente compatible con MCP.
period admite today, yesterday, 7days, 28days, 90days, 180days, 365days y custom_START_END.

Base URL

https://galite.io/api/v1

Cabecera

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Autenticación

Las API Keys se crean dentro de GA Lite. Guárdalas en el servidor y rótalas si quedan expuestas.

Cabecera

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

Proyectos

Los endpoints de proyectos devuelven los sitios a los que tienes acceso y las fuentes de datos conectadas a cada proyecto.

Listar proyectos

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

Métricas del sitio

Los endpoints de métricas leen datos de GA4 para un proyecto. Usa force=1 solo en flujos de actualización manual.

Resumen

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

Datos de búsqueda

Los endpoints de Search combinan datos de Google Search Console y Bing Webmaster. El parámetro sp elige all, gsc o bing.

Resumen de búsqueda

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

Embudos

Los embudos son de solo lectura en la API pública. Crea y edita las definiciones de embudo en el panel.

Listar embudos

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

Proxy de proveedor raw

Los endpoints raw proxy sirven para compatibilidad con formatos nativos de GA4, GSC o Bing. Prefiere los endpoints curados salvo que necesites una respuesta nativa del proveedor.

Informe 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

Los clientes MCP usan OAuth en el navegador por defecto. Las API Keys siguen disponibles como alternativa para scripts y clientes personalizados.

Endpoint MCP

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