{ "openapi": "3.0.1", "info": { "title": "Google Analytics MCP (GA4)", "description": "A powerful Google Analytics 4 Model Context Protocol (MCP) Actor that provides fast, reliable and customizable data analysis using your Google Analytics account. Perfect for businesses and marketers to unlock instant GA4 insights with flexible pay per event pricing.", "version": "1.0", "x-build-id": "IjEHY8AtTPXGcnvS8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smacient~ga4-mcp-worker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smacient-ga4-mcp-worker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/smacient~ga4-mcp-worker/runs": { "post": { "operationId": "runs-sync-smacient-ga4-mcp-worker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/smacient~ga4-mcp-worker/run-sync": { "post": { "operationId": "run-sync-smacient-ga4-mcp-worker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "googleTokens", "toolName" ], "properties": { "googleTokens": { "title": "Google OAuth Tokens", "required": [ "access_token" ], "type": "object", "description": "Google OAuth tokens obtained from MCP server", "properties": { "access_token": { "title": "Google Access Token", "type": "string", "description": "Google access token", "editor": "textfield" }, "refresh_token": { "title": "Google Refresh Token", "type": "string", "description": "Google refresh token", "editor": "textfield" } } }, "toolName": { "title": "Tool Name", "enum": [ "runReport", "runRealtimeReport", "runComparativeReport", "runReportWithOrdering", "getUserProperties", "listProperties", "listAccounts" ], "type": "string", "description": "Name of the GA4 tool to execute", "default": "getUserProperties" }, "toolArgs": { "title": "Tool Arguments", "type": "object", "description": "Arguments for the selected tool", "properties": { "propertyId": { "title": "Property ID", "type": "string", "description": "GA4 Property ID (for report tools)" }, "metrics": { "title": "Metrics", "type": "array", "description": "Metrics to retrieve", "items": { "type": "string" } }, "dimensions": { "title": "Dimensions", "type": "array", "description": "Dimensions to group by", "items": { "type": "string" } }, "startDate": { "title": "Start Date", "type": "string", "description": "Start date (YYYY-MM-DD)" }, "endDate": { "title": "End Date", "type": "string", "description": "End date (YYYY-MM-DD)" }, "accountId": { "title": "Account ID", "type": "string", "description": "GA4 Account ID (for listProperties)" }, "orderBy": { "title": "Order By", "type": "string", "description": "Metric to order by (for runReportWithOrdering)" }, "period1Start": { "title": "Period 1 Start Date", "type": "string", "description": "First period start date" }, "period1End": { "title": "Period 1 End Date", "type": "string", "description": "First period end date" }, "period2Start": { "title": "Period 2 Start Date", "type": "string", "description": "Second period start date" }, "period2End": { "title": "Period 2 End Date", "type": "string", "description": "Second period end date" } }, "default": {} } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }