{
"openapi": "3.0.1",
"info": {
"title": "Keyword Suggestions Scraper",
"description": "[$0.11/1K keywords] Keyword suggestions from Google, YouTube, Amazon, Bing, eBay and TikTok autocomplete with alphabet soup expansion: keyword, seed, source, position, intent, question flag. Long-tail keywords for SEO. No login, no run fee.",
"version": "0.1",
"x-build-id": "wVcGvpu9KX4ZNO4Na"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lergassy~keyword-suggestions-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lergassy-keyword-suggestions-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/lergassy~keyword-suggestions-scraper/runs": {
"post": {
"operationId": "runs-sync-lergassy-keyword-suggestions-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/lergassy~keyword-suggestions-scraper/run-sync": {
"post": {
"operationId": "run-sync-lergassy-keyword-suggestions-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": {
"keywords": {
"title": "🔍 Seed keywords",
"type": "array",
"description": "Enter one seed keyword per line. Each seed is typed into the autocomplete of every selected source, with the expansions below.",
"default": [
"running shoes"
],
"items": {
"type": "string"
}
},
"sources": {
"title": "🌐 Sources",
"type": "array",
"description": "Pick the autocomplete sources. A phrase suggested by several sources is one row with all of them in sources. Amazon and eBay use the marketplace of the country below.",
"items": {
"type": "string",
"enum": [
"google",
"youtube",
"amazon",
"bing",
"ebay",
"tiktok",
"duckduckgo",
"yandex",
"baidu",
"naver"
],
"enumTitles": [
"Google",
"YouTube",
"Amazon",
"Bing",
"eBay",
"TikTok",
"DuckDuckGo",
"Yandex",
"Baidu",
"Naver"
]
},
"default": [
"google"
]
},
"language": {
"title": "Language",
"type": "string",
"description": "Enter a two-letter language code: en, de, fr, es, id, ru, ja… Used by Google, YouTube, Bing, DuckDuckGo and Yandex.",
"default": "en"
},
"country": {
"title": "Country",
"type": "string",
"description": "Enter a two-letter country code: US, GB, DE, ID, AU… Localises Google, YouTube, Bing and DuckDuckGo, and picks the Amazon marketplace (US, GB, DE, FR, IT, ES, CA, JP, AU, MX, BR, NL, SE, PL, AE, SG, TR, SA, BE) and the eBay site (US, CA, GB, AU, AT, BE, FR, DE, IT, NL, ES, CH, IE, PL).",
"default": "US"
},
"expansions": {
"title": "🔤 Alphabet soup expansion",
"type": "array",
"description": "Choose how each seed is expanded into more autocomplete queries. Empty = only the seed itself (about 10 suggestions per source). Question words and prepositions are English.",
"items": {
"type": "string",
"enum": [
"alphabet",
"numbers",
"questions",
"prepositions"
],
"enumTitles": [
"Alphabet: seed + a…z",
"Numbers: seed + 0…9",
"Questions: how / what / why / can / is … + seed",
"Prepositions: seed + for / with / near / vs …"
]
},
"default": [
"alphabet"
]
},
"maxKeywordsPerSeed": {
"title": "💯 Max keywords per seed",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Set how many unique keywords to keep for each seed. The run stops asking a source once the limit is reached, so a low number is fast and cheap.",
"default": 50
},
"depth": {
"title": "Depth",
"minimum": 1,
"maximum": 2,
"type": "integer",
"description": "Set 2 to type every suggestion from level 1 back into autocomplete for long-tail keywords (1 = seed and its expansions only). Many more requests — raise Max keywords per seed with it.",
"default": 1
},
"customPrefixes": {
"title": "Custom prefixes",
"type": "array",
"description": "Add your own words to put before each seed, e.g. question words in your language: wie, comment, cara.",
"items": {
"type": "string"
}
},
"customSuffixes": {
"title": "Custom suffixes",
"type": "array",
"description": "Add your own words to put after each seed, e.g. 2026, for beginners, bali.",
"items": {
"type": "string"
}
},
"requireSeedWords": {
"title": "Keep only keywords that contain the seed words",
"type": "boolean",
"description": "Switch on to drop suggestions that do not contain every word of the seed (TikTok and Amazon sometimes suggest loosely related phrases). Dropped suggestions are not charged.",
"default": false
},
"excludeWords": {
"title": "Exclude keywords containing",
"type": "array",
"description": "Add words or brand names; suggestions containing any of them are dropped and not charged.",
"items": {
"type": "string"
}
},
"maxConcurrency": {
"title": "Parallel requests per source",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Set how many autocomplete requests run at once per source. The default is polite and fast; failed requests are retried with back-off.",
"default": 4
}
}
},
"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
}
}
}
}
}
}
}
}
}
}