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

http://galite.io/api/v1

الرأس

Authorization: Bearer sk_live_xxxxxxxxxxxxx

المصادقة

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

الرأس

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

المشاريع

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

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

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

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

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

الملخص

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 بيانات Google Search Console وBing Webmaster. يحدد معامل sp إحدى القيم all أو gsc أو bing.

ملخص البحث

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

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

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

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

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

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

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

تقرير GA4 خام

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

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

نقطة نهاية MCP

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