bldinit Google Analytics Rest API
The google_analytics-rest API from bldinit — 8 operation(s) for google_analytics-rest.
The google_analytics-rest API from bldinit — 8 operation(s) for google_analytics-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-analytics-rest-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Google Analytics Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: google_analytics-rest
paths:
/api/v1/google_analytics/v1beta/properties/{property}:runReport:
post:
tags:
- google_analytics-rest
summary: GA4 커스텀 리포트 실행 (dimension/metric/dateRange 자유 조합)
description: 'GA4 표준 보고서. dimension(분해 기준)과 metric(측정값)을 조합해 날짜별·채널별·
국가별 등 임의 리포트를 생성합니다.
**사전 준비**:
1. GCP Console에서 ``Google Analytics Data API`` 활성화 필수.
2. property_id 확인: ``google_analytics_list_accounts`` →
``google_analytics_list_properties`` 순서로 조회.
**property 형식**: 숫자 ID 만 (예: ``314552583``). ''properties/'' 접두 없이 숫자만 넣습니다
(게이트웨이가 ``properties/`` 를 경로에 자동으로 붙입니다). GA4 측정 ID ``G-XXXX`` 또는 스트림 ID 와 다릅니다.
**자주 쓰는 body 예시**:
```json
{
"dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
"dimensions": [{"name": "country"}, {"name": "sessionSourceMedium"}],
"metrics": [{"name": "activeUsers"}, {"name": "sessions"}],
"limit": 1000,
"returnPropertyQuota": true
}
```
**limit**: 기본 10,000, 최대 250,000. quota 보호를 위해 1,000~10,000 권장.
``returnPropertyQuota: true`` 를 넣으면 응답에 quota 소모량 포함.
**응답 주요 필드**: dimensionHeaders / metricHeaders / rows /
rowCount / metadata / propertyQuota / kind.
자주 쓰는 dimension: date / country / city / deviceCategory /
sessionSourceMedium / pagePath / eventName / platform.
자주 쓰는 metric: activeUsers / sessions / screenPageViews /
bounceRate / averageSessionDuration / conversions / totalRevenue.
전체 목록은 ``google_analytics_get_metadata`` 로 확인.'
operationId: google_analytics_run_report
parameters:
- name: property
in: path
required: true
schema:
type: string
title: Property
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analytics/v1beta/properties/{property}:runRealtimeReport:
post:
tags:
- google_analytics-rest
summary: GA4 실시간 리포트 (최근 30분 활성 사용자)
description: '최근 30분 이내의 실시간 트래픽을 조회합니다. 접속자 수·페이지·유입채널 등을
실시간으로 파악할 때 사용합니다.
**property 형식**: 숫자 ID 만 (예: ``314552583``). ''properties/'' 접두 없이 숫자만.
**body 예시**:
```json
{
"dimensions": [{"name": "unifiedScreenName"}],
"metrics": [{"name": "activeUsers"}],
"limit": 100
}
```
실시간 API 에서 사용 가능한 dimension/metric 은 표준 리포트와 다릅니다.
``google_analytics_get_metadata`` 로 ``kind=REALTIME`` 필터를 통해 확인하세요.'
operationId: google_analytics_run_realtime_report
parameters:
- name: property
in: path
required: true
schema:
type: string
title: Property
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analytics/v1beta/properties/{property}/metadata:
get:
tags:
- google_analytics-rest
summary: GA4 사용 가능한 dimension/metric 목록 조회 (LLM 리포트 조합 도우미)
description: '이 property 에서 사용 가능한 **모든 dimension 과 metric** 목록을 반환합니다.
커스텀 dimension/metric 포함. 리포트 작성 전에 먼저 호출해 유효한 apiName 을
확인하는 용도로 사용합니다.
**property 형식**: 숫자 ID 만 (예: ``314552583``). ''properties/'' 접두 없이 숫자만.
응답 예시:
```json
{
"dimensions": [{"apiName": "country", "uiName": "Country", ...}, ...],
"metrics": [{"apiName": "activeUsers", "uiName": "Active users", ...}, ...]
}
```
``google_analytics_check_compatibility`` 로 선택한 조합의 유효성을 사전 확인할 수 있습니다.'
operationId: google_analytics_get_metadata
parameters:
- name: property
in: path
required: true
schema:
type: string
title: Property
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analytics/v1beta/properties/{property}:checkCompatibility:
post:
tags:
- google_analytics-rest
summary: GA4 dimension/metric 조합 유효성 사전 확인
description: '선택한 dimension 과 metric 의 조합이 유효한지 **리포트 실행 전에** 확인합니다.
호환되지 않는 조합을 조기에 발견해 quota 낭비를 방지합니다.
**property 형식**: 숫자 ID 만 (예: ``314552583``). ''properties/'' 접두 없이 숫자만.
**body 예시**:
```json
{
"dimensions": [{"name": "country"}, {"name": "date"}],
"metrics": [{"name": "activeUsers"}, {"name": "sessions"}]
}
```
응답의 ``dimensionCompatibilities`` / ``metricCompatibilities`` 에서
각 항목의 ``compatibility`` 필드가 ``"COMPATIBLE"`` 인지 확인합니다.'
operationId: google_analytics_check_compatibility
parameters:
- name: property
in: path
required: true
schema:
type: string
title: Property
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analytics/v1beta/properties/{property}:batchRunReports:
post:
tags:
- google_analytics-rest
summary: GA4 여러 리포트 묶음 실행 (채널별·디바이스별 동시 조회)
description: '여러 개의 ``RunReportRequest`` 를 한 번의 API 호출로 실행합니다.
채널별 + 디바이스별 + 국가별 리포트를 동시에 가져올 때 사용합니다.
**property 형식**: 숫자 ID 만 (예: ``314552583``). ''properties/'' 접두 없이 숫자만.
**body 예시**:
```json
{
"requests": [
{
"dimensions": [{"name": "sessionSourceMedium"}],
"metrics": [{"name": "sessions"}, {"name": "conversions"}],
"dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
"limit": 100
},
{
"dimensions": [{"name": "deviceCategory"}],
"metrics": [{"name": "activeUsers"}],
"dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
"limit": 10
}
]
}
```
각 요청은 독립적으로 처리되며, 응답의 ``reports[]`` 배열에 순서대로 반환됩니다.
quota 는 각 요청 개별 소모됩니다.'
operationId: google_analytics_batch_run_reports
parameters:
- name: property
in: path
required: true
schema:
type: string
title: Property
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analyticshttps://analyticsadmin.googleapis.com/v1beta/accounts:
get:
tags:
- google_analytics-rest
summary: GA4 계정 목록 조회 (property ID 발견 1단계)
description: '이 OAuth 앱으로 접근 가능한 **GA4 계정 목록**을 반환합니다.
property ID 를 모를 때 ``accounts.list`` → ``properties.list`` 순서로
발견(discover)하는 흐름의 1단계입니다.
응답의 ``accounts[].name`` (예: ``accounts/123456``) 을
``google_analytics_list_properties`` 의 ``filter`` 파라미터에 사용합니다:
``filter=parent:accounts/123456``
**주의**: Admin API 호출 (analyticsadmin.googleapis.com).
GCP Console에서 ``Google Analytics Admin API`` 도 활성화되어 있어야 합니다.'
operationId: google_analytics_list_accounts
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: pageSize
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagesize
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: showDeleted
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Showdeleted
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analyticshttps://analyticsadmin.googleapis.com/v1beta/accountSummaries:
get:
tags:
- google_analytics-rest
summary: GA4 계정+속성 요약 (property ID 발견 — 가장 권장)
description: '이 OAuth 앱으로 접근 가능한 **모든 GA4 계정과 그 속성**을 한 번에 반환합니다.
``accountSummaries[].propertySummaries[].property`` (예: ``properties/314552583``)
에서 **숫자 부분만** (``314552583``) run_report / get_metadata 등의 ``property``
파라미터에 넣습니다 (``properties/`` 접두는 빼고 — 게이트웨이가 자동으로 붙입니다).
⭐ **계정 단위 권한뿐 아니라 속성 단위로 공유받은 속성까지** 모두 보이므로,
property 탐색에는 ``list_accounts`` → ``list_properties`` 보다 이 엔드포인트가
더 정확합니다(다른 사람이 속성 단위로 공유한 GA4 속성은 list_accounts 에 안 보임).
**주의**: Admin API 호출 (analyticsadmin.googleapis.com).'
operationId: google_analytics_list_account_summaries
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: pageSize
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagesize
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_analyticshttps://analyticsadmin.googleapis.com/v1beta/properties:
get:
tags:
- google_analytics-rest
summary: GA4 property 목록 조회 (property ID 발견 2단계)
description: '계정 하위의 **GA4 property 목록**을 반환합니다.
``google_analytics_list_accounts`` 로 얻은 ``accounts/{id}`` 를
``filter`` 파라미터에 넣어 호출합니다.
**filter 필수**: ``parent:accounts/{accountId}`` 형식.
예: ``filter=parent:accounts/123456``
응답의 ``properties[].name`` (예: ``properties/123456789``) 에서 **숫자 부분만**
(``123456789``) Data API (runReport 등) 의 ``property`` 파라미터로 사용합니다
(``properties/`` 접두 없이 — 게이트웨이가 경로에 자동으로 붙입니다).
**응답 주요 필드**: name / propertyId / displayName / parent /
timeZone / currencyCode / propertyType / industryCategory.
**주의**: Admin API 호출 (analyticsadmin.googleapis.com).'
operationId: google_analytics_list_properties
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: filter
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Filter
- name: pageSize
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagesize
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: showDeleted
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Showdeleted
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)