{ "openapi": "3.0.1", "info": { "title": "Google, Bing & YouTube Keyword Suggest Scraper", "description": "Generate long-tail keyword ideas from Google, Bing, and YouTube autocomplete. Expand up to 100 seed keywords with A–Z, digits, and custom modifiers, localize by language and country, deduplicate results, and export structured keyword data for SEO, PPC, content, and market research.", "version": "0.1", "x-build-id": "5JkAkmEUogkGaTHXd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnatan029~keyword-autocomplete-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnatan029-keyword-autocomplete-intelligence", "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/johnatan029~keyword-autocomplete-intelligence/runs": { "post": { "operationId": "runs-sync-johnatan029-keyword-autocomplete-intelligence", "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/johnatan029~keyword-autocomplete-intelligence/run-sync": { "post": { "operationId": "run-sync-johnatan029-keyword-autocomplete-intelligence", "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": "1–100 seed keywords (e.g. \"crm software\"). Each seed expands to ~37 queries in expand mode (~260+ unique long-tails measured).", "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "expand", "suggest" ], "type": "string", "description": "expand (default): seed + a-z + 0-9 (+ modifiers) — the long-tail harvest. suggest: one direct query per seed.", "default": "expand" }, "sources": { "title": "Sources", "type": "array", "description": "google (web autocomplete), bing (osjson), youtube (Google suggest with ds=yt). Prefill includes Google + Bing for redundancy — if one source changes its response contract, the other keeps the run alive (controlled per-source status, partial survival).", "items": { "type": "string", "enum": [ "google", "bing", "youtube" ] }, "default": [ "google" ] }, "language": { "title": "Language (hl)", "type": "string", "description": "Autocomplete language, e.g. \"en\", \"pt\", \"de\". Verified working with pt/br.", "default": "en" }, "country": { "title": "Country (gl)", "type": "string", "description": "2-letter country code for regional suggestions, e.g. \"us\", \"br\".", "default": "us" }, "modifiers": { "title": "Custom modifiers (optional)", "type": "array", "description": "Extra expansion terms applied as prefix AND suffix (e.g. \"how\", \"best\", \"vs\" → \"how crm software\" and \"crm software how\"). Max 20; each adds 2 queries per seed.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max charged keywords per run", "minimum": 1, "maximum": 25000, "type": "integer", "description": "Global cap on charged keyword records. The free RUN_SUMMARY does not count.", "default": 5000 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 100, "maximum": 2000, "type": "integer", "description": "Polite pacing before every request (serial per source; sources run in parallel). The 100 ms floor is deliberate.", "default": 250 }, "debug": { "title": "Debug logging", "type": "boolean", "description": "Verbose logs.", "default": false } } }, "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 } } } } } } } } } }