API 문서 · GA Lite

빠른 시작

계정 설정에서 API Key를 만든 뒤 Bearer token으로 전송합니다. 모든 API route는 read-only이며 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

검색 데이터

Search endpoint는 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에서 퍼널은 read-only입니다. 퍼널 정의는 대시보드에서 만들고 수정하세요.

퍼널 목록

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

Raw provider proxy

Raw proxy endpoint는 GA4, GSC, Bing의 네이티브 요청 형식과의 호환을 위한 것입니다. provider-native 응답이 필요한 경우가 아니라면 정리된 endpoint를 우선 사용하세요.

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

MCP endpoint

MCP 클라이언트는 기본적으로 브라우저 OAuth를 사용합니다. API Keys는 스크립트와 커스텀 클라이언트의 fallback으로 계속 사용할 수 있습니다.

MCP endpoint

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