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

Швидкий старт

Створіть ключ API в налаштуваннях облікового запису й надсилайте його як токен Bearer. Відповіді API мають формат JSON.

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

Базова URL-адреса

https://app.galite.io/api/v1

Заголовок

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Автентифікація

API Keys створюються в GA Lite. Зберігайте їх на сервері та змінюйте, якщо вони були розкриті.

Заголовок

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

Проєкти

Ендпоінти проєктів повертають сайти, до яких ви маєте доступ, і джерела даних, підключені до кожного проєкту.

Список проєктів

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

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

Ендпоінти метрик читають дані GA4 для одного проєкту. Використовуйте force=1 лише для ручного оновлення.

Зведення

GET https://app.galite.io/api/v1/metrics/{projectKey}/summary?period=28days
GET https://app.galite.io/api/v1/metrics/{projectKey}/timeseries?period=28days&metric=screenPageViews
GET https://app.galite.io/api/v1/metrics/{projectKey}/dimension?dimension=country&period=28days
GET https://app.galite.io/api/v1/metrics/{projectKey}/realtime

Пошукові дані

Ендпоінти Search об’єднують дані Google Search Console і Bing Webmaster. Параметр sp вибирає all, gsc або bing.

Зведення пошуку

GET https://app.galite.io/api/v1/metrics/{projectKey}/search/summary?period=28days&sp=all
GET https://app.galite.io/api/v1/metrics/{projectKey}/search/timeseries?period=28days&sp=gsc
GET https://app.galite.io/api/v1/metrics/{projectKey}/search/dimension?dimension=query&period=28days&sp=bing

Воронки

Через публічне API воронки доступні лише для читання. MCP може перевірити записані події та сторінки й створити воронку після вашого явного підтвердження. Створювати та редагувати визначення воронок, як і раніше, можна на панелі керування.

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

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

Raw provider proxy

Raw proxy endpoints потрібні для сумісності з нативними форматами запитів GA4, GSC або Bing. Надавайте перевагу підготовленим endpoints, якщо не потрібна нативна відповідь provider.

Raw звіт GA4

POST https://app.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-варіантом для скриптів і власних клієнтів.

MCP endpoint

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