{ "openapi": "3.0.1", "info": { "title": "Long-Tail Keyword Finder: Google, YouTube, Amazon, Bing", "description": "Turn one seed keyword into hundreds of real long-tail phrases from the autocomplete of Google, YouTube, Bing, DuckDuckGo, Amazon and eBay at once, each with the platforms that suggested it and whether it is a question, a comparison or a buying phrase. No key, no login, no proxy.", "version": "0.1", "x-build-id": "JKTvEjv5wnnfp29KZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/precious_bathmat~long-tail-keyword-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-precious_bathmat-long-tail-keyword-finder", "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/precious_bathmat~long-tail-keyword-finder/runs": { "post": { "operationId": "runs-sync-precious_bathmat-long-tail-keyword-finder", "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/precious_bathmat~long-tail-keyword-finder/run-sync": { "post": { "operationId": "run-sync-precious_bathmat-long-tail-keyword-finder", "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": [ "seeds" ], "properties": { "seeds": { "title": "Seed keywords", "type": "array", "description": "The words you want expanded, one per line. Short seeds return more: \"running shoes\" beats \"best running shoes for flat feet\".", "items": { "type": "string" } }, "platforms": { "title": "Platforms", "type": "array", "description": "Which autocompletes to read. Google and Bing show what people search on the web, YouTube what they search in video, Amazon and eBay what they search when they are ready to buy.", "items": { "type": "string", "enum": [ "google", "youtube", "bing", "duckduckgo", "amazon", "ebay" ], "enumTitles": [ "Google", "YouTube", "Bing", "DuckDuckGo", "Amazon", "eBay" ] }, "default": [ "google", "youtube", "bing", "duckduckgo", "amazon", "ebay" ] }, "expansions": { "title": "How to expand each seed", "type": "array", "description": "Letters add \"seed a\" to \"seed z\". Questions add how, what, why and the rest, in front and behind. Buying words add best, cheap, price, review. Prepositions add for, with, near, vs.", "items": { "type": "string", "enum": [ "alphabet", "questions", "commercial", "prepositions" ], "enumTitles": [ "Letters a to z", "Question words", "Buying words", "Prepositions" ] }, "default": [ "alphabet", "questions", "commercial" ] }, "language": { "title": "Language", "enum": [ "en", "es", "de", "fr", "it", "pt", "nl", "pl", "tr", "ja", "hi", "ar" ], "type": "string", "description": "The language the suggestions come back in. The country the suggestions reflect follows the server, which is in the United States.", "default": "en" }, "market": { "title": "Shopping market", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "AU", "JP", "BR", "MX" ], "type": "string", "description": "Which Amazon, eBay and Bing market to read. This is the one real country setting: Amazon and eBay answer per country.", "default": "US" }, "includeTrends": { "title": "Label which keywords are growing (Google Trends)", "type": "boolean", "description": "Adds Google Trends to every seed: whether the seed itself is rising or falling, which of the suggested keywords are growing and by how much, and the growing searches Trends knows that no autocomplete offers. Free — it does not change what a run costs.", "default": true }, "trendsTimeframe": { "title": "Period to judge growth over", "enum": [ "today 3-m", "today 12-m", "today 5-y" ], "type": "string", "description": "How far back Google Trends looks when deciding what is rising.", "default": "today 12-m" }, "maxKeywordsPerSeed": { "title": "Maximum keywords per seed", "minimum": 50, "maximum": 5000, "type": "integer", "description": "A cap on what a run costs. Keywords are kept in score order, so the cap drops the weakest ones first.", "default": 1000 } } }, "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 } } } } } } } } } }