GA Lite

للمطورين

توثيق API

استخدم API من GA Lite لقراءة بيانات Google Analytics 4 (GA4) وGoogle Search Console (GSC) وBing Webmaster Tools من السكربتات أو التطبيقات أو عملاء AI.

البدء السريع

أنشئ API Key من إعدادات الحساب، ثم أرسله كـ Bearer token. جميع مسارات API للقراءة فقط وتعيد JSON.

  • استخدم /api/v1 للقراءة بأسلوب REST.
  • استخدم /api/mcp عند توصيل Claude أو Cursor أو أي عميل يدعم MCP.
  • يدعم period القيم today وyesterday و7days و28days و90days و180days و365days وcustom_START_END.

Base URL

https://galite.io/api/v1

الرأس

Authorization: Bearer sk_live_xxxxxxxxxxxxx

المصادقة

يتم إنشاء API Keys داخل GA Lite. احتفظ بها على الخادم وقم بتدويرها إذا تم كشفها.

الرأس

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

المشاريع

تعيد نقاط نهاية المشاريع المواقع التي يمكنك الوصول إليها ومصادر البيانات المتصلة بكل مشروع.

قائمة المشاريع

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

مقاييس الموقع

تقرأ نقاط نهاية المقاييس بيانات GA4 لمشروع واحد. استخدم force=1 فقط في مسارات التحديث اليدوي.

الملخص

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

بيانات البحث

تجمع نقاط نهاية Search بيانات Google Search Console وBing Webmaster. يحدد معامل sp إحدى القيم all أو gsc أو bing.

ملخص البحث

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

مسارات التحويل

مسارات التحويل متاحة للقراءة فقط عبر API العامة. أنشئ وعدّل تعريفات المسارات في لوحة التحكم.

قائمة المسارات

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

وكيل المزود الخام

تُستخدم نقاط نهاية raw proxy للتوافق مع صيغ طلبات GA4 أو GSC أو Bing الأصلية. فضّل النقاط المنسقة إلا إذا كنت تحتاج إلى استجابة أصلية من المزود.

تقرير GA4 خام

POST https://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

يستخدم عملاء MCP تفويض OAuth عبر المتصفح افتراضيًا. تبقى API Keys متاحة كخيار احتياطي للسكربتات والعملاء المخصصين.

نقطة نهاية MCP

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