{ "openapi": "3.0.1", "info": { "title": "Keyword Explorer API — SemRush / Ahrefs / Moz Alternative", "description": "Request bounded Google Ads metrics, matching terms, related terms, or keyword suggestions through DataForSEO. Returns normalized rows with endpoint provenance and terminal outcomes.", "version": "1.2", "x-build-id": "3HLe1lqd8k9xdxtce" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~ahrefs-keyword-explorer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-ahrefs-keyword-explorer", "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/khadinakbar~ahrefs-keyword-explorer/runs": { "post": { "operationId": "runs-sync-khadinakbar-ahrefs-keyword-explorer", "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/khadinakbar~ahrefs-keyword-explorer/run-sync": { "post": { "operationId": "run-sync-khadinakbar-ahrefs-keyword-explorer", "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": { "report": { "title": "Research report", "enum": [ "overview", "matching_terms", "related_terms", "search_suggestions" ], "type": "string", "description": "Choose the DataForSEO Labs report. Overview returns metrics for exact supplied terms. Matching terms, related terms, and keyword ideas discover new keyword opportunities from the supplied seeds.", "default": "overview" }, "keywords": { "title": "Seed keywords", "minItems": 1, "maxItems": 10, "type": "array", "description": "One or more keyword phrases for the selected report, such as web scraping. Blank and duplicate values are removed before the seed cap is applied. This is not a domain or URL field.", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "locationCode": { "title": "DataForSEO location code", "minimum": 1, "type": "integer", "description": "Numeric DataForSEO location identifier used to target the report. Use 2840 for the United States, 2826 for the United Kingdom, or another supported DataForSEO location. This is not an ISO country code.", "default": 2840 }, "languageCode": { "title": "Language code", "pattern": "^[A-Za-z]{2,10}$", "type": "string", "description": "DataForSEO language code used with the selected location, such as en for English. Defaults to en and must be two to ten letters. This is not a locale such as en-US.", "default": "en" }, "maxResults": { "title": "Maximum result rows", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum normalized rows persisted across the entire run. The Actor requests no more than 100 rows and stops before charging beyond this cap. DataForSEO may bill its API request independently of this Apify row cap.", "default": 50 }, "maxSeedKeywords": { "title": "Maximum seed keywords", "minimum": 1, "maximum": 10, "type": "integer", "description": "Safety cap applied after blank and duplicate seeds are removed. Discovery reports can make one DataForSEO request per retained seed, so a smaller value makes provider usage predictable. Defaults to three and never exceeds ten.", "default": 3 } } }, "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 } } } } } } } } } }