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

http://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 http://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 http://galite.io/api/v1/projects/list
GET http://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 http://galite.io/api/v1/metrics/{projectKey}/summary?period=28days
GET http://galite.io/api/v1/metrics/{projectKey}/timeseries?period=28days&metric=screenPageViews
GET http://galite.io/api/v1/metrics/{projectKey}/dimension?dimension=country&period=28days
GET http://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 http://galite.io/api/v1/metrics/{projectKey}/search/summary?period=28days&sp=all
GET http://galite.io/api/v1/metrics/{projectKey}/search/timeseries?period=28days&sp=gsc
GET http://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 http://galite.io/api/v1/projects/{projectKey}/funnels/list
GET http://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 http://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 http://galite.io/api/mcp