{ "openapi": "3.0.1", "info": { "title": "Google Keyword Planner Alternative - Ideas, Bids & Volume", "description": "Get keyword ideas from Google Keyword Planner without a Google Ads account: enter seed keywords or a website URL and get ideas with monthly search volume, CPC, competition and top-of-page bids. $3 per 1,000 ideas + $0.12 per request; ideas without volume are free.", "version": "1.0", "x-build-id": "hJ2uHrFe416hDqnRl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~google-keyword-planner/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-google-keyword-planner", "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/tenfoldfleet~google-keyword-planner/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-google-keyword-planner", "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/tenfoldfleet~google-keyword-planner/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-google-keyword-planner", "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": { "seedKeywords": { "title": "Seed keywords", "type": "array", "description": "Keywords to get ideas for, one per line, like the 'Start with keywords' box in Google Keyword Planner. Every 20 seeds make one Keyword Planner request (up to 200 seeds per run). Seeds are lowercased and deduplicated; symbols Google does not accept (, ! @ % ^ ( ) = { } ; ~ ` < > ? \\ |) are removed. Seeds longer than 80 characters or 10 words are skipped for free.", "items": { "type": "string" } }, "url": { "title": "Website or page URL (optional)", "type": "string", "description": "Get keyword ideas for a website, like the 'Start with a website' box in Google Keyword Planner. A domain (\"semrush.com\") uses the whole site; a URL with a path (\"https://example.com/blog/post\") uses that page only. Works on its own or together with seed keywords (one extra request)." }, "location": { "title": "Country", "type": "string", "description": "Country whose Google search volume, CPC and bids you want. A country name or 2-letter code works (\"United States\", \"US\", \"GB\", \"Germany\"); 94 countries.", "default": "United States" }, "language": { "title": "Language", "type": "string", "description": "Search language, as a name or code (\"English\", \"en\", \"de\"). If the language has no data for the chosen country, the country's main language is used instead (for example Germany + English uses German).", "default": "English" }, "maxIdeas": { "title": "Max keyword ideas", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum keyword ideas returned per run, shared across all requests (one request returns about 1,000-3,000 ideas). Ideas are filtered and sorted before the cut, and you only pay for ideas returned.", "default": 500 }, "minSearchVolume": { "title": "Minimum monthly search volume", "minimum": 0, "type": "integer", "description": "Only return ideas with at least this many average monthly searches. 0 returns every idea, including ideas Google has no volume for (those are free).", "default": 0 }, "sortBy": { "title": "Sort ideas by", "enum": [ "relevance", "search_volume" ], "type": "string", "description": "relevance = Google Keyword Planner's order; search_volume = highest monthly searches first. The sort runs before the cut to Max keyword ideas.", "default": "relevance" }, "includeAdultKeywords": { "title": "Include adult keywords", "type": "boolean", "description": "Include adult keyword ideas. Off by default, as in Google Keyword Planner.", "default": false } } }, "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 } } } } } } } } } }