{ "openapi": "3.0.1", "info": { "title": "Long-Tail Keyword Finder — Long Tail Pro Alternative", "description": "Find long-tail keyword ideas from seed phrases. Export search volume, CPC, competition, available difficulty and intent, plus a transparent opportunity score for content planning. Supply your DataForSEO credentials.", "version": "1.0", "x-build-id": "Uk45GmvtkYbHnmXFx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~longtailpro-alternative/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-longtailpro-alternative", "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~longtailpro-alternative/runs": { "post": { "operationId": "runs-sync-khadinakbar-longtailpro-alternative", "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~longtailpro-alternative/run-sync": { "post": { "operationId": "run-sync-khadinakbar-longtailpro-alternative", "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": [ "seedKeywords" ], "properties": { "seedKeywords": { "title": "Seed keywords", "minItems": 1, "maxItems": 5, "type": "array", "description": "Provide 1-5 starting phrases, for example [\"project management software\"]. The Actor expands these into related Google keyword candidates. Blank and duplicate values are removed. This is not a domain, URL, or Google search operator field.", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "locationCode": { "title": "Google location code", "minimum": 1, "type": "integer", "description": "Set the DataForSEO Google location code, such as 2840 for the United States. It scopes the returned keyword metrics to that geography. Defaults to 2840 and must be positive. This is not an ISO country code.", "default": 2840 }, "languageCode": { "title": "Google language code", "pattern": "^[a-zA-Z]{2,5}$", "type": "string", "description": "Set the DataForSEO language code, such as en. It scopes the language of the idea and metric response. Defaults to en. This is not a natural-language name such as English.", "default": "en" }, "maxResults": { "title": "Maximum keyword candidates", "minimum": 1, "maximum": 100, "type": "integer", "description": "Choose the maximum normalized candidates to persist. The Actor caps this at 100 to make event and provider costs predictable. Defaults to 25. This is not unbounded provider pagination.", "default": 25 }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Keep candidates whose provider-reported average monthly search volume meets this floor. Defaults to zero so valid zero estimates remain visible. Use this to narrow a research export. This is not a traffic or conversion forecast.", "default": 0 }, "maxKeywordDifficulty": { "title": "Maximum keyword difficulty", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep candidates at or below this DataForSEO difficulty threshold. Defaults to 100, which retains available difficulty values. Set 35 for a lower-competition shortlist. This is not a guarantee of rankings.", "default": 100 }, "opportunityProfile": { "title": "Prioritization profile", "enum": [ "balanced", "low_competition", "commercial" ], "type": "string", "description": "Choose how the transparent opportunity score weighs retained candidates. low_competition gives an extra preference to lower reported difficulty; commercial favors commercial or transactional intent. Defaults to low_competition. This does not alter the provider source metrics.", "default": "low_competition" }, "includeSerpFeatures": { "title": "Include SERP features", "type": "boolean", "description": "Request available SERP feature types alongside each keyword candidate. Defaults to true to show whether the provider saw result types such as people-also-ask. This is not a live position check or full SERP export.", "default": true }, "dataforSeoLogin": { "title": "DataForSEO login", "type": "string", "description": "Provide your DataForSEO API login only when the owner secret is unavailable. This confidential value is sent only in the authorization header and is never written to the dataset, output, or logs. This is not an Apify token." }, "dataforSeoPassword": { "title": "DataForSEO API password", "type": "string", "description": "Provide your DataForSEO API password only when the owner secret is unavailable. This confidential value is sent only in the authorization header and is never written to the dataset, output, or logs. This is not your dashboard password." } } }, "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 } } } } } } } } } }