API Dokümantasyonu

Hızlı başlangıç

Hesap ayarlarından bir API Key oluşturun ve Bearer token olarak gönderin. Tüm API route'ları read-only çalışır ve JSON döndürür.

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.

Base URL

http://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 http://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 http://galite.io/api/v1/projects/list
GET http://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 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

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 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

Huniler

Huniler public API üzerinden read-only sunulur. Huni tanımlarını dashboard içinde oluşturup düzenleyin.

Hunileri listele

GET http://galite.io/api/v1/projects/{projectKey}/funnels/list
GET http://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 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" }]
  }
}

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 http://galite.io/api/mcp