API دستاویزات

فوری آغاز

اکاؤنٹ کی ترتیبات میں API کلید بنائیں، پھر اسے Bearer ٹوکن کے طور پر بھیجیں۔ API کے جوابات JSON فارمیٹ میں ہوتے ہیں۔

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

بنیادی URL

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

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

تصدیق

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

Header

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

پراجیکٹس

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

Projects list

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

Site metrics

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

Summary

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 data

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

Search summary

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

Funnels

عوامی API کے ذریعے فنلز صرف پڑھے جا سکتے ہیں۔ MCP ریکارڈ شدہ ایونٹس اور صفحات کی جانچ کر کے آپ کی واضح تصدیق کے بعد فنل بنا سکتا ہے۔ آپ ڈیش بورڈ میں پہلے کی طرح فنل کی تعریفیں بنا اور ترمیم کر سکتے ہیں۔

Funnels list

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

Raw GA4 report

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

MCP endpoint

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