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

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"

پروژه‌ها

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

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

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

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

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

داده جستجو

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

پروکسی خام Provider

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

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

Endpoint MCP

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

Endpoint MCP

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