{ "openapi": "3.0.1", "info": { "title": "Keyword Search Volume & CPC – Google Ads Data", "description": "Google Ads Keyword Planner search volume, CPC, competition and 12-month trend for any keyword list, in any country and language. Licensed data through the DataForSEO API, nothing scraped: paste up to 100,000 keywords and get clean rows for $3 per 1,000 plus $0.10 per lookup of 1,000.", "version": "0.1", "x-build-id": "oLckyXSvtjZswNcoK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/publicrows~keyword-search-volume/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-publicrows-keyword-search-volume", "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/publicrows~keyword-search-volume/runs": { "post": { "operationId": "runs-sync-publicrows-keyword-search-volume", "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/publicrows~keyword-search-volume/run-sync": { "post": { "operationId": "run-sync-publicrows-keyword-search-volume", "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": { "keywords": { "title": "keywords", "type": "string", "description": "One keyword per line (commas also work), up to 80 characters each. 1,000 keywords travel in one request, so 5,000 keywords take five requests.", "default": "buy laptop\ncheap laptops for sale\nbest budget laptop 2026\nlaptop under 50000\ngaming laptop\nlaptop for students\nrefurbished laptop\nlaptop deals\nmacbook air m4 price\nlaptop with 16gb ram\nthin and light laptop\nlaptop for video editing\nchromebook vs laptop\nlaptop battery life\nlaptop repair near me\ndell laptop\nhp laptop\nlenovo laptop\nasus laptop\nacer laptop" }, "location": { "title": "location", "enum": [ "2840", "2826", "2356", "2124", "2036", "2276", "2250", "2724", "2380", "2528", "2076", "2484", "2702", "2784", "2710", "2392", "2158", "2458", "2608", "2566" ], "type": "string", "description": "Country the volumes are for (Google Ads location). More locations on request.", "default": "2840" }, "language": { "title": "language", "enum": [ "en", "hi", "es", "fr", "de", "it", "pt", "nl", "ja", "ar", "id", "ms", "tl", "zh-TW" ], "type": "string", "description": "Language of the searches.", "default": "en" }, "searchPartners": { "title": "searchPartners", "type": "boolean", "description": "Include Google's search partner network in the volumes (off = Google Search only, matching Keyword Planner's default).", "default": false }, "sandbox": { "title": "sandbox", "type": "boolean", "description": "Use the supplier's test environment: same row structure, dummy numbers, no supplier charge. For wiring tests only.", "default": false }, "dfsLogin": { "title": "dfsLogin", "type": "string", "description": "Optional: your own DataForSEO API login (the account e-mail). Leave empty to use ours." }, "dfsPassword": { "title": "dfsPassword", "type": "string", "description": "Optional: your own DataForSEO API password. Leave empty to use ours." }, "maxItems": { "title": "Max rows", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many rows.", "default": 5000 } } }, "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 } } } } } } } } } }