Документация API

Быстрый старт

Создайте API Key в настройках аккаунта и отправляйте его как Bearer token. Все API-маршруты доступны только для чтения и возвращают JSON.

Используйте /api/v1 для REST-чтения.
Используйте /api/mcp при подключении Claude, Cursor или другого MCP-клиента.
period поддерживает today, yesterday, 7days, 28days, 90days, 180days, 365days и custom_START_END.

Base URL

https://galite.io/api/v1

Заголовок

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Аутентификация

API Keys создаются в GA Lite. Храните их на сервере и меняйте при раскрытии.

Заголовок

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

Проекты

Эндпоинты проектов возвращают сайты, к которым у вас есть доступ, и источники данных, подключенные к каждому проекту.

Список проектов

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

Метрики сайта

Эндпоинты метрик читают данные GA4 для одного проекта. Используйте force=1 только для ручного обновления.

Сводка

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 объединяют данные Google Search Console и Bing Webmaster. Параметр sp выбирает all, gsc или bing.

Сводка поиска

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

Воронки

Воронки доступны через публичное API только для чтения. Создавайте и редактируйте определения воронок в dashboard.

Список воронок

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 нужны для совместимости с нативными форматами запросов GA4, GSC или Bing. Предпочитайте подготовленные endpoints, если не нужна нативная response провайдера.

Raw отчет GA4

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-клиенты по умолчанию используют OAuth в браузере. API Keys остаются fallback-вариантом для скриптов и custom clients.

MCP endpoint

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