API دستاویزات

فوری آغاز

اکاؤنٹ سیٹنگز سے API Key بنائیں، پھر اسے Bearer token کے طور پر بھیجیں۔ تمام API routes read-only ہیں اور JSON واپس کرتے ہیں۔

REST طرز کی reads کے لیے /api/v1 استعمال کریں۔
Claude، Cursor یا کسی MCP-aware client کو جوڑتے وقت /api/mcp استعمال کریں۔
period today، yesterday، 7days، 28days، 90days، 180days، 365days اور custom_START_END کو سپورٹ کرتا ہے۔

Base URL

http://galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

تصدیق

API Keys GA Lite کے اندر بنتی ہیں۔ انہیں server-side محفوظ رکھیں اور افشا ہونے پر rotate کریں۔

Header

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

پراجیکٹس

Project endpoints وہ sites واپس کرتے ہیں جن تک آپ کو رسائی ہے اور ہر project سے جڑے data sources بھی۔

Projects list

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

Site metrics

Metrics endpoints ایک project کے GA4 data کو پڑھتے ہیں۔ force=1 صرف manual refresh flows میں استعمال کریں۔

Summary

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

Search data

Search endpoints Google Search Console اور Bing Webmaster data کو ملاتے ہیں۔ sp parameter all، gsc یا bing منتخب کرتا ہے۔

Search summary

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

Funnels

Public API میں funnels read-only ہیں۔ Funnel definitions dashboard میں بنائیں اور edit کریں۔

Funnels list

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 endpoints native GA4، GSC یا Bing request shapes کے ساتھ compatibility کے لیے ہیں۔ Provider-native response درکار نہ ہو تو curated endpoints کو ترجیح دیں۔

Raw GA4 report

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 clients default طور پر browser OAuth استعمال کرتے ہیں۔ API Keys scripts اور custom clients کے لیے fallback رہتی ہیں۔

MCP endpoint

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