API Dokümantasyonu

Hızlı başlangıç

Hesap ayarlarında bir API anahtarı oluşturun ve Bearer belirteci olarak gönderin. API yanıtları JSON biçimindedir.

REST tarzı okumalar için /api/v1 kullanın.
Claude, Cursor veya başka bir MCP uyumlu istemci bağlarken /api/mcp kullanın.
period today, yesterday, 7days, 28days, 90days, 180days, 365days ve custom_START_END değerlerini destekler.

Temel URL

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

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Kimlik doğrulama

API Keys GA Lite içinde oluşturulur. Bunları sunucu tarafında saklayın ve açığa çıkarsa değiştirin.

Header

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

Projeler

Proje endpoint'leri erişebildiğiniz siteleri ve her projeye bağlı veri kaynaklarını döndürür.

Projeleri listele

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

Site metrikleri

Metrik endpoint'leri tek bir proje için GA4 verilerini okur. force=1 yalnızca manuel yenileme akışlarında kullanılmalıdır.

Özet

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

Arama verileri

Search endpoint'leri Google Search Console ve Bing Webmaster verilerini birleştirir. sp parametresi all, gsc veya bing seçer.

Arama özeti

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

Huniler

Huniler genel API üzerinden salt okunurdur. MCP, kaydedilmiş etkinlikleri ve sayfaları inceleyip açık onayınızdan sonra bir huni oluşturabilir. Huni tanımlarını kontrol panelinde oluşturmaya ve düzenlemeye devam edebilirsiniz.

Hunileri listele

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 endpoint'leri native GA4, GSC veya Bing request biçimleriyle uyumluluk içindir. Provider-native response gerekmediği sürece curated endpoint'leri tercih edin.

Raw GA4 raporu

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 istemcileri varsayılan olarak browser OAuth kullanır. API Keys scriptler ve özel istemciler için fallback olarak kullanılmaya devam eder.

MCP endpoint

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