{ "openapi": "3.0.1", "info": { "title": "Google Keyword Planner MCP", "description": "A comprehensive Google Keyword Planner MCP Actor that provides keyword research, search volume analysis, and location-based targeting using Google's official data. Ideal for SEO professionals, digital marketers, and content creators seeking data-driven keyword strategies.", "version": "1.0", "x-build-id": "SgUhyteTvgghor9Xo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smacient~google-keyword-planner-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smacient-google-keyword-planner-mcp", "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~google-keyword-planner-mcp/runs": { "post": { "operationId": "runs-sync-smacient-google-keyword-planner-mcp", "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~google-keyword-planner-mcp/run-sync": { "post": { "operationId": "run-sync-smacient-google-keyword-planner-mcp", "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", "properties": { "tool": { "title": "Analysis Type", "enum": [ "get_keyword_ideas", "get_historical_keyword_data", "get_month_over_month_analysis" ], "type": "string", "description": "Select the type of keyword analysis:\n• Keyword Ideas: Find new keyword suggestions with search volumes\n• Historical Data: View search trends over time (24 months)\n• Month-over-Month: Compare performance across months", "default": "get_keyword_ideas" }, "keywords": { "title": "Keywords to Analyze", "type": "string", "description": "Enter one or more keywords separated by commas. Examples: 'digital marketing, seo services, content writing'\n\n• Use 1-5 seed keywords for best results\n• Each keyword should be 1-10 words\n• Avoid special characters" }, "locations": { "title": "Target Locations", "uniqueItems": true, "type": "array", "description": "Select one or more countries or cities to analyze. This determines which market's search data you'll receive.\n\n• Choose broad locations (countries) for general research\n• Choose specific cities for local targeting\n• Multiple locations will be analyzed separately", "items": { "type": "string", "enum": [ "United States", "India", "Canada", "United Kingdom", "Australia", "Germany", "France", "Japan", "Brazil", "Mexico", "Malaysia", "Spain", "New Zealand", "Switzerland", "Netherlands", "Singapore", "Sweden", "Norway", "Denmark", "Ireland", "South Africa", "Philippines", "Thailand", "Indonesia", "UAE", "Saudi Arabia", "Pakistan", "Bangladesh", "Nigeria", "Kenya", "Mumbai, India", "Delhi, India", "Bangalore, India", "Chennai, India", "Kolkata, India", "Hyderabad, India", "Pune, India", "New York, NY", "Los Angeles, CA", "London, UK", "Toronto, Canada", "Sydney, Australia" ] }, "default": [ "India" ] }, "resultLimit": { "title": "Maximum Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of keyword suggestions to return (only applies to 'Get Keyword Ideas').\n\n• Min: 1, Max: 100\n• Higher limits may take longer to process\n• Recommended: 20-50 for balanced speed and coverage", "default": 20 }, "exportCsv": { "title": "Export CSV", "type": "boolean", "description": "Include CSV formatted data in the results. Useful for importing into spreadsheets or other tools.", "default": false }, "languageId": { "title": "Language Code", "pattern": "^[0-9]{4}$", "type": "string", "description": "Language for keyword analysis. Most common:\n• 1000 = English\n• 1001 = German\n• 1002 = French\n• 1003 = Spanish\n• 1005 = Japanese", "default": "1000" } } }, "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 } } } } } } } } } }