GA Lite

Nhà phát triển

Tài liệu API

Dùng API GA Lite để đọc dữ liệu Google Analytics 4 (GA4), Google Search Console (GSC) và Bing Webmaster Tools từ script, ứng dụng hoặc AI client.

Bắt đầu nhanh

Tạo API Key trong phần cài đặt tài khoản, rồi gửi dưới dạng Bearer token. Tất cả API route đều chỉ đọc và trả về JSON.

  • Dùng /api/v1 cho các lần đọc kiểu REST.
  • Dùng /api/mcp khi kết nối Claude, Cursor hoặc client hỗ trợ MCP khác.
  • period hỗ trợ today, yesterday, 7days, 28days, 90days, 180days, 365days và custom_START_END.

Base URL

http://galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

Xác thực

API Keys được tạo trong GA Lite. Hãy lưu ở phía server và xoay vòng nếu bị lộ.

Header

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

Dự án

Endpoint dự án trả về các site bạn có quyền truy cập và nguồn dữ liệu đã kết nối với từng dự án.

Danh sách dự án

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

Chỉ số site

Endpoint chỉ số đọc dữ liệu GA4 cho một dự án. Chỉ dùng force=1 cho luồng làm mới thủ công.

Tóm tắt

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

Dữ liệu tìm kiếm

Endpoint Search gộp dữ liệu Google Search Console và Bing Webmaster. Tham số sp chọn all, gsc hoặc bing.

Tóm tắt tìm kiếm

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

Phễu

Phễu chỉ đọc qua public API. Tạo và chỉnh sửa định nghĩa phễu trong dashboard.

Danh sách phễu

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

Raw provider proxy

Endpoint raw proxy dùng để tương thích với dạng request gốc của GA4, GSC hoặc Bing. Ưu tiên endpoint đã chuẩn hóa trừ khi cần response native từ provider.

Báo cáo GA4 raw

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 endpoint

MCP client mặc định dùng OAuth trên trình duyệt. API Keys vẫn có thể dùng làm fallback cho script và client tùy chỉnh.

MCP endpoint

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