เอกสาร API

เริ่มต้นอย่างรวดเร็ว

สร้าง 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

https://galite.io/api/v1

Header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

การยืนยันตัวตน

API Keys ถูกสร้างใน GA Lite เก็บไว้ฝั่งเซิร์ฟเวอร์และหมุนเวียนใหม่หากรั่วไหล

Header

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

Funnels

Funnels ใน Public API เป็นแบบอ่านอย่างเดียว สร้างและแก้ไขคำจำกัดความของ funnel ในแดชบอร์ด

รายการ funnels

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

Raw provider proxy

Endpoint raw proxy ใช้เพื่อรองรับรูปแบบ request ดั้งเดิมของ GA4, GSC หรือ Bing ควรใช้ endpoint ที่จัดเตรียมไว้ก่อน เว้นแต่ต้องการ response ดั้งเดิมจาก provider

รายงาน GA4 raw

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" }]
  }
}

MCP endpoint

ไคลเอนต์ MCP ใช้ OAuth ผ่านเบราว์เซอร์โดยค่าเริ่มต้น API Keys ยังใช้เป็น fallback สำหรับสคริปต์และไคลเอนต์แบบกำหนดเองได้

MCP endpoint

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