{ "openapi": "3.0.1", "info": { "title": "Semrush Alternative — SEO Keyword & SERP Data", "description": "Run bounded DataForSEO reports for domain organic keywords, Google SERPs, and keyword difficulty with your own provider credentials.", "version": "1.0", "x-build-id": "tWq8vvczSFH2Gk8oo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~semrush-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-semrush-api-scraper", "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~semrush-api-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-semrush-api-scraper", "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~semrush-api-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-semrush-api-scraper", "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": { "dataforSeoLogin": { "title": "DataForSEO API login", "type": "string", "description": "Your DataForSEO API login, usually the email shown on the API access page. It is sent only in the request authorization header and is never returned or logged. This is not your Apify email." }, "dataforSeoPassword": { "title": "DataForSEO API password", "type": "string", "description": "Your DataForSEO API password from API access, not your dashboard password. It is sent only in the request authorization header and is never returned or logged. Pair it with dataforSeoLogin from the same provider account." }, "mode": { "title": "Report mode", "enum": [ "domain_organic_keywords", "keyword_serp", "keyword_difficulty" ], "type": "string", "description": "Select the DataForSEO report to run. Domain organic keywords accepts domains; Google organic SERP and keyword difficulty accept keywords. Each mode returns a distinct source-backed record type.", "default": "domain_organic_keywords" }, "domains": { "title": "Domains", "type": "array", "description": "Domains for the domain organic-keywords mode, for example [\"example.com\"]. URLs are normalized to domains and duplicates are removed. Ignored by keyword modes; maximum 20 unique domains.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords for Google organic SERP or keyword difficulty, for example [\"technical seo\"]. Each keyword is processed independently and duplicates are removed. Ignored by domain organic-keywords mode; maximum 20 unique keywords.", "items": { "type": "string" } }, "locationCode": { "title": "DataForSEO location code", "minimum": 1, "type": "integer", "description": "DataForSEO location code for the Google market, for example 2840 for the United States. The code applies to every query in the run. This is not a country-code string.", "default": 2840 }, "languageCode": { "title": "DataForSEO language code", "type": "string", "description": "DataForSEO language code for the report, for example en. It is paired with the location code and applies to every query. This is not a browser interface language selector.", "default": "en" }, "maxResults": { "title": "Maximum rows per input", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum DataForSEO rows requested for each input, from 1 to 20. The run also has a hard cap of 20 billable persisted rows across all inputs. DataForSEO request usage depends on your provider plan and report.", "default": 10 } } }, "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 } } } } } } } } } }