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 khóa API trong phần cài đặt tài khoản, rồi gửi dưới dạng mã thông báo Bearer. Phản hồi API sử dụng định dạng 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.

URL cơ sở

https://app.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 https://app.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 https://app.galite.io/api/v1/projects/list
GET https://app.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 https://app.galite.io/api/v1/metrics/{projectKey}/summary?period=28days
GET https://app.galite.io/api/v1/metrics/{projectKey}/timeseries?period=28days&metric=screenPageViews
GET https://app.galite.io/api/v1/metrics/{projectKey}/dimension?dimension=country&period=28days
GET https://app.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 https://app.galite.io/api/v1/metrics/{projectKey}/search/summary?period=28days&sp=all
GET https://app.galite.io/api/v1/metrics/{projectKey}/search/timeseries?period=28days&sp=gsc
GET https://app.galite.io/api/v1/metrics/{projectKey}/search/dimension?dimension=query&period=28days&sp=bing

Phễu

API công khai chỉ cho phép đọc phễu. MCP có thể kiểm tra các sự kiện và trang đã ghi nhận, rồi tạo phễu sau khi bạn xác nhận rõ ràng. Bạn vẫn có thể tạo và chỉnh sửa định nghĩa phễu trong bảng điều khiển như bình thường.

Danh sách phễu

GET https://app.galite.io/api/v1/projects/{projectKey}/funnels/list
GET https://app.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 https://app.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 https://app.galite.io/api/mcp