API Docs · GA Lite

Quick start

Create an API key from your account settings, then send it as a Bearer token. All API routes are read-only and return JSON.

Use /api/v1 for REST-style reads.
Use /api/mcp when connecting Claude, Cursor or another MCP-aware client.
Periods support today, yesterday, 7days, 28days, 90days, 180days, 365days and custom_START_END.

Base URL

https://galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Authentication

API keys are created inside GA Lite. Keep them server-side and rotate them if they are exposed.

Header

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

Projects

Project endpoints return the sites you can access and the data sources connected to each project.

List projects

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

Site metrics

Metrics endpoints read GA4 data for one project. Use force=1 only for manual refresh flows.

Summary

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

Search data

Search endpoints combine Google Search Console and Bing Webmaster data. The sp parameter chooses all, gsc or bing.

Search summary

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

Funnels are read-only through the public API. Create and edit funnel definitions in the dashboard.

List funnels

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

Raw provider proxy

Raw proxy endpoints are for compatibility with native GA4, GSC or Bing request shapes. Prefer curated endpoints unless you need a provider-native response.

Raw GA4 report

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" }]
  }
}

MCP endpoint

MCP clients use browser OAuth by default. API keys remain available as a fallback for scripts and custom clients.

MCP endpoint

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