{ "openapi": "3.0.1", "info": { "title": "Keyword Search Volume, CPC & Difficulty", "description": "Google search volume, CPC, competition, keyword difficulty, search intent and a monthly trend for up to 20,000 keywords per run, or related keyword ideas from seed keywords. Data from DataForSEO. No API key or Google Ads account needed. Pay per keyword with data.", "version": "0.0", "x-build-id": "FuQUl90TAzs7BzKlC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bjgomes~keyword-search-volume-cpc-difficulty/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bjgomes-keyword-search-volume-cpc-difficulty", "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/bjgomes~keyword-search-volume-cpc-difficulty/runs": { "post": { "operationId": "runs-sync-bjgomes-keyword-search-volume-cpc-difficulty", "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/bjgomes~keyword-search-volume-cpc-difficulty/run-sync": { "post": { "operationId": "run-sync-bjgomes-keyword-search-volume-cpc-difficulty", "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": "The keywords to look up, one per item. In 'Metrics' mode each keyword gets one row (up to 20,000 per run). In 'Ideas' mode these are the seed keywords (up to 200) and you get related keywords back. Keywords are lowercased and duplicates dropped; a keyword over 80 characters or 10 words, or with an emoji, is skipped with an error row and not charged.", "items": { "type": "string" } }, "mode": { "title": "What to get", "enum": [ "metrics", "ideas" ], "type": "string", "description": "'Metrics': search volume, CPC, competition, difficulty and intent for exactly the keywords you give. 'Ideas': related keywords for your seed keywords, each with the same metrics.", "default": "metrics" }, "location": { "title": "Location", "type": "string", "description": "Where the searches happen: a country or place name as DataForSEO writes it ('United States', 'United Kingdom', 'London,England,United Kingdom'), or a DataForSEO location code (2840 is the United States). List: https://docs.dataforseo.com/v3/dataforseo_labs/locations_and_languages/", "default": "United States" }, "language": { "title": "Language", "type": "string", "description": "The searchers' language: a code such as 'en', 'de' or 'es', or a name such as 'English'.", "default": "en" }, "historyMonths": { "title": "Months of search history", "minimum": 0, "maximum": 60, "type": "integer", "description": "How many months of monthly search volumes to include per keyword, newest last. 0 leaves the monthly list out (smaller rows). The trend fields (month, quarter and year change) are always there.", "default": 12 }, "maxIdeas": { "title": "Maximum ideas", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Ideas mode only: stop after this many keyword ideas. Each idea is one charged row.", "default": 100 }, "minSearchVolume": { "title": "Minimum monthly searches", "minimum": 0, "type": "integer", "description": "Ideas mode only: leave out ideas with fewer average monthly searches than this. 0 keeps every idea that has a volume.", "default": 0 }, "ideasSortBy": { "title": "Sort ideas by", "enum": [ "relevance", "searchVolume" ], "type": "string", "description": "Ideas mode only: closest to your seeds first, or most searched first.", "default": "relevance" } } }, "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 } } } } } } } } } }