GA Lite

توسعه‌دهندگان

مستندات API

با APIِ GA Lite داده‌های Google Analytics 4 (GA4)، Google Search Console (GSC) و Bing Webmaster Tools را از اسکریپت‌ها، اپ‌ها یا کلاینت‌های AI بخوانید.

شروع سریع

از تنظیمات حساب یک API Key بسازید و آن را به صورت Bearer token ارسال کنید. همه مسیرهای API فقط خواندنی هستند و JSON برمی‌گردانند.

  • برای خواندن به سبک REST از /api/v1 استفاده کنید.
  • برای اتصال Claude، Cursor یا هر کلاینت سازگار با MCP از /api/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"

پروژه‌ها

Endpointهای پروژه سایت‌هایی را که به آن‌ها دسترسی دارید و منابع داده متصل به هر پروژه را برمی‌گردانند.

فهرست پروژه‌ها

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

شاخص‌های سایت

Endpointهای شاخص داده 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

داده جستجو

Endpointهای 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

پروکسی خام Provider

Endpointهای raw proxy برای سازگاری با شکل درخواست‌های بومی GA4، GSC یا Bing هستند. مگر اینکه پاسخ بومی Provider لازم داشته باشید، از endpointهای آماده استفاده کنید.

گزارش خام 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" }]
  }
}

Endpoint MCP

کلاینت‌های MCP به‌طور پیش‌فرض از OAuth مرورگر استفاده می‌کنند. API Keys همچنان برای اسکریپت‌ها و کلاینت‌های سفارشی به‌عنوان جایگزین در دسترس است.

Endpoint MCP

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