{ "openapi": "3.0.1", "info": { "title": "Google Keyword Research - Search Volume, CPC & Difficulty", "description": "Find keyword ideas with Google monthly search volume, CPC, competition, keyword difficulty, search intent and 12-month trends for any country.", "version": "1.0", "x-build-id": "hiFi02uwyje523bnz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seemuapps~google-keyword-research/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seemuapps-google-keyword-research", "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/seemuapps~google-keyword-research/runs": { "post": { "operationId": "runs-sync-seemuapps-google-keyword-research", "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/seemuapps~google-keyword-research/run-sync": { "post": { "operationId": "run-sync-seemuapps-google-keyword-research", "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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Seed keywords to research, one per line. In Keyword suggestions mode each seed is researched separately. In Keyword ideas mode all seeds are combined into one search. In Metrics mode each keyword gets its own row.", "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "suggestions", "ideas", "metrics" ], "type": "string", "description": "Keyword suggestions: long-tail keywords that contain your seed phrase. Keyword ideas: related keywords from the same topic, even without your words. Metrics only: volume, CPC and difficulty for exactly the keywords you enter.", "default": "suggestions" }, "market": { "title": "Country & language", "enum": [ "2008:sq", "2012:ar", "2012:fr", "2024:pt", "2032:es", "2051:hy", "2036:en", "2040:de", "2031:az", "2048:ar", "2050:bn", "2056:nl", "2056:fr", "2056:de", "2068:es", "2070:bs", "2076:pt", "2100:bg", "2854:fr", "2116:en", "2120:fr", "2124:en", "2124:fr", "2152:es", "2170:es", "2188:es", "2384:fr", "2191:hr", "2196:en", "2196:el", "2203:cs", "2208:da", "2218:es", "2818:ar", "2818:en", "2222:es", "2233:et", "2246:fi", "2250:fr", "2276:de", "2288:en", "2300:en", "2300:el", "2320:es", "2344:zh-TW", "2344:en", "2348:hu", "2356:en", "2356:hi", "2360:en", "2360:id", "2372:en", "2376:ar", "2376:he", "2380:it", "2392:ja", "2400:ar", "2398:ru", "2404:en", "2428:lv", "2440:lt", "2458:en", "2458:ms", "2470:en", "2484:es", "2498:ro", "2492:fr", "2504:ar", "2504:fr", "2104:en", "2528:nl", "2554:en", "2558:es", "2566:en", "2807:mk", "2578:nb", "2586:en", "2586:ur", "2591:es", "2600:es", "2604:es", "2608:en", "2608:tl", "2616:pl", "2620:pt", "2642:ro", "2682:ar", "2682:en", "2686:fr", "2688:sr", "2702:zh-CN", "2702:en", "2703:sk", "2705:sl", "2710:en", "2410:ko", "2724:es", "2144:en", "2752:sv", "2756:fr", "2756:de", "2756:it", "2158:zh-TW", "2764:th", "2788:ar", "2792:tr", "2804:ru", "2804:uk", "2784:ar", "2784:en", "2826:en", "2840:en", "2840:es", "2858:es", "2862:es", "2704:en", "2704:vi" ], "type": "string", "description": "Which Google market to pull search volume, CPC and difficulty for.", "default": "2840:en" }, "maxResultsPerKeyword": { "title": "Max results per seed keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum keywords to return per seed (Keyword suggestions) or per search (Keyword ideas), sorted by search volume, highest first. Up to 1000. Ignored in Metrics mode.", "default": 50 }, "minSearchVolume": { "title": "Minimum monthly search volume", "minimum": 0, "type": "integer", "description": "Only return keywords with at least this many monthly searches. 0 returns everything.", "default": 0 }, "includeSeedKeyword": { "title": "Include the seed keyword", "type": "boolean", "description": "In Keyword suggestions mode, add a row for the seed keyword itself at the top of its results.", "default": true } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }