Documentação da API

Início rápido

Crie uma API Key nas definições da conta e envie-a como Bearer token. Todas as rotas da API são só de leitura e devolvem JSON.

Use /api/v1 para leituras ao estilo REST.
Use /api/mcp ao ligar Claude, Cursor ou outro cliente compatível com MCP.
period suporta today, yesterday, 7days, 28days, 90days, 180days, 365days e custom_START_END.

Base URL

https://galite.io/api/v1

Cabeçalho

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Autenticação

As API Keys são criadas dentro da GA Lite. Guarde-as no servidor e faça rotação se forem expostas.

Cabeçalho

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

Projetos

Os endpoints de projetos devolvem os sites a que tem acesso e as fontes de dados ligadas a cada projeto.

Listar projetos

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

Métricas do site

Os endpoints de métricas leem dados GA4 de um projeto. Use force=1 apenas em fluxos de atualização manual.

Resumo

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

Dados de pesquisa

Os endpoints Search combinam dados do Google Search Console e Bing Webmaster. O parâmetro sp escolhe all, gsc ou bing.

Resumo de pesquisa

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

Funis

Os funis são só de leitura na API pública. Crie e edite definições de funil no painel.

Listar funis

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

Proxy raw do fornecedor

Os endpoints raw proxy servem para compatibilidade com formatos nativos GA4, GSC ou Bing. Prefira endpoints curados, salvo quando precisar de uma resposta nativa do fornecedor.

Relatório 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

Os clientes MCP usam OAuth no navegador por predefinição. As API Keys continuam disponíveis como alternativa para scripts e clientes personalizados.

Endpoint MCP

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