{ "openapi": "3.0.1", "info": { "title": "Keyword Suggestions Tool (Free): Google, Amazon & YouTube", "description": "Free keyword research tool: Google autocomplete suggestions plus TikTok, YouTube, Amazon, Bing, DuckDuckGo and app store autocomplete (App Store, Google Play), any country and language. Seeds expanded A-Z, with questions, 2 levels deep: long-tail and ASO keyword ideas. Export CSV, JSON, Excel.", "version": "0.1", "x-build-id": "nwjQxaLf0cYcWEEYv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/euroscrape~keyword-suggestions-free/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-euroscrape-keyword-suggestions-free", "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/euroscrape~keyword-suggestions-free/runs": { "post": { "operationId": "runs-sync-euroscrape-keyword-suggestions-free", "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/euroscrape~keyword-suggestions-free/run-sync": { "post": { "operationId": "run-sync-euroscrape-keyword-suggestions-free", "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": { "keywords": { "title": "Seed keywords", "type": "array", "description": "One keyword per line (up to 500). Each one is expanded into dozens of suggestions.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Which autocomplete to read. Each source adds its own suggestions (YouTube for video topics, Amazon for product searches, TikTok for what people look for on TikTok, App Store and Google Play for app searches: ASO keyword research).", "items": { "type": "string", "enum": [ "google", "youtube", "amazon", "bing", "duckduckgo", "tiktok", "appstore", "googleplay" ], "enumTitles": [ "Google", "YouTube", "Amazon", "Bing", "DuckDuckGo", "TikTok", "App Store", "Google Play" ] }, "default": [ "google" ] }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code (US, GB, FR, DE, ES, IT, CA, AU, IN…). For Amazon: the marketplace of that country; for the App Store: that country's storefront.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code (en, fr, de, es, it, pt, nl…). Also sets the question words and prepositions.", "default": "en" }, "alphabet": { "title": "Expand A–Z and 0–9", "type": "boolean", "description": "Type the keyword followed by each letter and digit (“electric bike a”, “electric bike b”…): about 36 times more suggestions.", "default": true }, "questions": { "title": "Question keywords", "type": "boolean", "description": "Add question words before the keyword (how, what, why, best…): ideas for FAQ and blog posts.", "default": false }, "prepositions": { "title": "Prepositions and comparisons", "type": "boolean", "description": "Add words after the keyword (for, with, vs, near, price, review…).", "default": false }, "depth": { "title": "Depth", "minimum": 0, "maximum": 2, "type": "integer", "description": "0 = suggestions of the seed only. 1 = also expand every suggestion found (many more long-tail keywords). 2 = one more level.", "default": 0 }, "mergeSources": { "title": "One row per keyword (merge sources)", "type": "boolean", "description": "With several sources: one row per keyword with the list of sources that suggest it (sources, sourceCount, positions per source), keywords found everywhere first. Off: one row per keyword and source.", "default": false }, "maxSuggestions": { "title": "Maximum suggestions", "minimum": 1, "type": "integer", "description": "The run stops after this many unique suggestions.", "default": 5000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy spreads requests over several IPs. Without proxy, very large runs may be slowed down by the sources.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }