bldinit Google Analytics Rest API

The google_analytics-rest API from bldinit — 8 operation(s) for google_analytics-rest.

GitHub OpenAPI

Operations 8

POST /api/v1/google_analytics/v1beta/properties/{property}:runReport GA4 커스텀 리포트 실행 (dimension/metric/dateRange 자유 조합) #
POST /api/v1/google_analytics/v1beta/properties/{property}:runRealtimeReport GA4 실시간 리포트 (최근 30분 활성 사용자) #
GET /api/v1/google_analytics/v1beta/properties/{property}/metadata GA4 사용 가능한 dimension/metric 목록 조회 (LLM 리포트 조합 도우미) #
POST /api/v1/google_analytics/v1beta/properties/{property}:checkCompatibility GA4 dimension/metric 조합 유효성 사전 확인 #
POST /api/v1/google_analytics/v1beta/properties/{property}:batchRunReports GA4 여러 리포트 묶음 실행 (채널별·디바이스별 동시 조회) #
GET /api/v1/google_analyticshttps://analyticsadmin.googleapis.com/v1beta/accounts GA4 계정 목록 조회 (property ID 발견 1단계) #
GET /api/v1/google_analyticshttps://analyticsadmin.googleapis.com/v1beta/accountSummaries GA4 계정+속성 요약 (property ID 발견 — 가장 권장) #
GET /api/v1/google_analyticshttps://analyticsadmin.googleapis.com/v1beta/properties GA4 property 목록 조회 (property ID 발견 2단계) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-analytics-rest-api"
All apis
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.

Get an API 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 Specification

mcpweave-com-google-analytics-rest-api-openapi.yml Raw ↑
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)