# Keyword Suggest Multi (`habit.zhou/keyword-suggest-multi`) Actor Fetches keyword suggestions from Google, Bing, DuckDuckGo, YouTube, Amazon, eBay, Yandex, Baidu, and Naver for a batch of seed keywords in one country. - **URL**: https://apify.com/habit.zhou/keyword-suggest-multi.md - **Developed by:** [Seller Aim](https://apify.com/habit.zhou) (community) - **Categories:** E-commerce, SEO tools, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Keyword Suggest Multi > **9 search engines. 1 API call. Every keyword your audience actually types.** Query the autocomplete/suggest endpoints of **Google, Bing, DuckDuckGo, YouTube, Amazon, eBay, Yandex, Baidu, and Naver** for a batch of seed keywords, in any target country — and get back a clean dataset plus a ranked, deduplicated summary. Built for SEO researchers, content planners, e-commerce sellers, and marketers who are tired of running nine separate tools. --- ### Why this Actor - **9 engines in parallel** — stop juggling single-engine keyword tools. One input, one output, one set of billing credits. - **AnswerThePublic-style long-tail expansion** — optional A–Z / question / preposition / comparison modifiers turn one seed into ~100 related queries **across all 9 engines**, surfacing thousands of long-tail suggestions per seed. - **Country-native by default** — a single `country` input (US, DE, JP, CN, KR, ...) auto-routes each engine to its local endpoint, language, and marketplace across 25 pre-configured markets. - **Analysis-ready output** — row-per-suggestion dataset for drill-down, plus a cross-engine-ranked `SUMMARY.json` where suggestions bubble up by consensus across multiple engines. - **Built to not break** — round-robin budget truncation (no seed gets starved when hitting the request cap), per-source error tracking, JSONP-tolerant parsers for Baidu and eBay, session pool + retry via Crawlee. - **Covered by 71 unit tests** — including real-response fixtures for all 9 sources. Not a YOLO. --- ### Quick start **Input**: ```json { "seeds": ["iphone 15", "samsung galaxy s24"], "country": "US", "expansionSlices": ["alphabet", "questions"] } ```` **Dataset row** (one per suggestion × source): ```json { "seed": "iphone 15", "source": "google", "suggestion": "iphone 15 pro max review", "expansionSlice": "alphabet", "query": "iphone 15 r", "rank": 3, "country": "US", "language": "en", "scrapedAt": "2026-04-17T06:31:19.211Z" } ``` **Key-Value Store `SUMMARY`** (merged + ranked): ```json { "meta": { "country": "US", "seeds": ["iphone 15", "samsung galaxy s24"], "sourcesUsed": ["google","bing","duckduckgo","youtube","amazon","ebay"], "requestsTotal": 882, "requestsSucceeded": 879, "suggestionsRaw": 7104, "suggestionsUniquePerSeed": 2118 }, "perSeed": { "iphone 15": { "total": 3540, "unique": 1055, "bySource": { "google": 492, "bing": 408, "amazon": 380, "...": "..." }, "topSuggestions": [ { "suggestion": "iphone 15 pro max", "sources": ["amazon","bing","ebay","google","yandex"], "occurrences": 5, "bestRank": 0 } ] } } } ``` The `topSuggestions` ranking sorts by **cross-engine consensus first** (how many engines surfaced it), then by **best rank** (best-performing position across engines) — so the top of the list is genuinely "what people search for," not noise from a single engine. *** ### Use cases - **SEO keyword research** — discover every query around your topic plus the intent signals from 9 different engines. - **E-commerce product-listing optimization** — Amazon & eBay autocomplete reveals how real shoppers phrase their searches. - **Content planning** — enable `questions` expansion and you get the "how / what / why / when / where" queries begging for blog posts. - **Competitive research** — suggestions that appear across multiple engines are mass-market intent, not a one-engine quirk. - **Ad-copy ideation** — real completions become ad-variation seeds. - **Market-entry research** — run the same seeds across `US`, `DE`, `JP`, `MX` to compare how different audiences search. *** ### Inputs | Field | Type | Required | Default | Notes | |---|---|---|---|---| | `seeds` | `string[]` (1–50) | yes | — | Unique entries auto-enforced | | `country` | ISO 3166-1 alpha-2 | yes | — | `US`, `GB`, `DE`, `JP`, `CN`, `KR`, `RU`, etc. | | `sources` | `string[]` | no | all 9 | Subset of the 9 engines | | `expansionSlices` | `string[]` | no | `[]` | See Expansion table below | | `maxRequestsPerRun` | `integer` | no | `5000` | Hard cap; round-robin truncation by seed | | `maxConcurrency` | `integer` | no | `10` | Parallel request limit | | `summaryTopN` | `integer` | no | `200` | Per-seed cap on `topSuggestions` | | `proxyConfiguration` | `object` | no | Apify default | Standard Apify proxy config | #### Sources `google`, `bing`, `duckduckgo`, `youtube`, `amazon`, `ebay`, `yandex`, `baidu`, `naver`. #### Expansion slices Turn each seed into dozens of related queries, AnswerThePublic-style: | Slice | Pattern | Example (`seed = "car"`) | Count per seed | |---|---|---|---| | `alphabet` | `{seed} {a-z, 0-9}` | `car a`, `car b`, ..., `car 9` | 36 | | `prefixAlphabet` | `{a-z, 0-9} {seed}` | `a car`, `b car`, ..., `9 car` | 36 | | `questions` | `{wh-word} {seed}` | `how car`, `why car`, `does car` | 13 | | `prepositions` | `{seed} {for/with/near/...}` | `car for`, `car with`, `car near` | 7 | | `comparisons` | `{seed} {vs/or/versus}` | `car vs`, `car or`, `car versus` | 4 | Enable any subset (e.g. `["alphabet", "questions"]`). Full expansion ≈ 97 queries per seed × 9 engines ≈ 873 requests/seed. *** ### Country coverage 25 pre-configured markets. Each entry carries the local language, Google `gl/hl`, Bing `market`, DuckDuckGo `kl`, Amazon TLD, eBay siteId, and Yandex region ID: | Region | Markets | |---|---| | Americas | `US` `CA` `MX` `BR` | | Europe | `GB` `DE` `FR` `IT` `ES` `NL` `SE` `PL` `TR` `RU` | | Asia | `JP` `KR` `CN` `TH` `VN` `ID` `IN` | | Middle East | `SA` `AE` | | Oceania | `AU` | | Africa | `ZA` | Unknown countries fall back to generic English (with a warning in the log). **Engine availability rules**: - **Baidu / Naver / Yandex** default **off** outside their native markets (CN / KR / RU). Forcing them via explicit `sources` input is allowed — a warning is logged, and results may be weak. - **Amazon** is skipped where no marketplace exists (e.g. RU, KR, TH, VN, ID). - **eBay** is skipped where no site ID exists. - **Google / Bing / DuckDuckGo / YouTube** work globally. The `SUMMARY.meta.sourcesSkipped` object in every run records which engines were dropped and why. *** ### Output details #### Dataset (row per suggestion) All 9 fields are always populated (no missing values): ``` seed, source, suggestion, expansionSlice, query, rank, country, language, scrapedAt ``` `rank` is 0-indexed position within that specific engine response. `expansionSlice = "seed"` marks rows from the original seed (no expansion modifier applied). #### SUMMARY.json (Key-Value Store) ``` { "meta": { "country", "language", "seeds", "sourcesRequested", "sourcesUsed", "sourcesSkipped", "sourcesWithErrors", "expansionSlices", "requestsTotal", "requestsSucceeded", "requestsFailed", "suggestionsRaw", "suggestionsUniquePerSeed", "startedAt", "finishedAt", "durationMs", "truncated", "truncatedFrom", "localeFallback", "crawleeStats" }, "perSeed": { "": { "total": , "unique": , "bySource": { "": , ... }, "topSuggestions": [ { "suggestion", "sources", "occurrences", "bestRank" }, ... ] } } } ``` `topSuggestions` ordering: `occurrences` desc → `bestRank` asc → alphabetical (deterministic, so two identical runs produce identical summaries). Capped at `summaryTopN` per seed. *** ### Limitations (honest notes) - **No search volumes, CPC, or competition scores.** This Actor returns suggestion strings only. Combine with a metrics API if you need numbers. - **One country per run.** Need multi-country comparison? Schedule multiple runs. - **Expansion modifier tables are English in v1.** Works fine cross-language because engines auto-localize the generated queries, but not yet optimal for deep native research in non-English markets. - **Autocomplete is rate-limit tolerant but not infinite.** Aggressive expansion × many seeds × all 9 engines × a tight country can trip rate limiters. Tune `maxConcurrency` and `maxRequestsPerRun` for your scale. *** ### Example inputs Quick SEO scan on a single seed: ```json { "seeds": ["standing desk"], "country": "US" } ``` Full long-tail expansion: ```json { "seeds": ["standing desk"], "country": "US", "expansionSlices": ["alphabet", "questions", "prepositions", "comparisons"] } ``` Batch e-commerce research across marketplaces (one country at a time): ```json { "seeds": ["wireless earbuds", "mechanical keyboard", "standing desk"], "country": "DE", "sources": ["google", "amazon", "ebay"], "expansionSlices": ["alphabet"] } ``` Chinese market (auto-enables Baidu): ```json { "seeds": ["手机壳"], "country": "CN" } ``` *** ### Local development ```bash npm install npm test ## 71 unit tests npm run test:integration ## one real Google request ``` See `docs/superpowers/specs/2026-04-17-keyword-suggest-multi-design.md` for the full design spec, and `docs/superpowers/plans/2026-04-17-keyword-suggest-multi-plan.md` for the 18-task TDD build plan this Actor was created with. # Actor input Schema ## `seeds` (type: `array`): 1–50 seed keywords to fetch suggestions for. ## `country` (type: `string`): ISO 3166-1 alpha-2 country code (e.g. US, DE, JP, CN). ## `sources` (type: `array`): Subset of search engines to query. Defaults to all nine. ## `expansionSlices` (type: `array`): A-Z / question / preposition / comparison / prefix-alphabet expansion. Empty = no expansion. ## `maxRequestsPerRun` (type: `integer`): Hard cap on generated requests. If exceeded, tuples are truncated round-robin by seed. ## `maxConcurrency` (type: `integer`): Global max parallel HTTP requests. ## `summaryTopN` (type: `integer`): Cap on topSuggestions per seed in SUMMARY.json. 0 disables topSuggestions. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. ## Actor input object example ```json { "seeds": [ "iphone 15" ], "country": "US", "sources": [ "google", "bing", "duckduckgo", "youtube", "amazon", "ebay", "yandex", "baidu", "naver" ], "expansionSlices": [], "maxRequestsPerRun": 5000, "maxConcurrency": 10, "summaryTopN": 200, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `suggestions` (type: `string`): One row per (seed × source × suggestion) with rank, expansionSlice, query, country, language, scrapedAt. ## `summary` (type: `string`): Merged, deduplicated, cross-engine-ranked view: run metadata + per-seed topSuggestions + bySource counts. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "seeds": [ "iphone 15" ], "country": "US", "sources": [ "google", "bing", "duckduckgo", "youtube", "amazon", "ebay", "yandex", "baidu", "naver" ], "expansionSlices": [], "maxRequestsPerRun": 5000, "maxConcurrency": 10, "summaryTopN": 200, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("habit.zhou/keyword-suggest-multi").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "seeds": ["iphone 15"], "country": "US", "sources": [ "google", "bing", "duckduckgo", "youtube", "amazon", "ebay", "yandex", "baidu", "naver", ], "expansionSlices": [], "maxRequestsPerRun": 5000, "maxConcurrency": 10, "summaryTopN": 200, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("habit.zhou/keyword-suggest-multi").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "seeds": [ "iphone 15" ], "country": "US", "sources": [ "google", "bing", "duckduckgo", "youtube", "amazon", "ebay", "yandex", "baidu", "naver" ], "expansionSlices": [], "maxRequestsPerRun": 5000, "maxConcurrency": 10, "summaryTopN": 200, "proxyConfiguration": { "useApifyProxy": true } }' | apify call habit.zhou/keyword-suggest-multi --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=habit.zhou/keyword-suggest-multi", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Keyword Suggest Multi", "description": "Fetches keyword suggestions from Google, Bing, DuckDuckGo, YouTube, Amazon, eBay, Yandex, Baidu, and Naver for a batch of seed keywords in one country.", "version": "0.2", "x-build-id": "R1Ip7N0TNFygTuRYf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/habit.zhou~keyword-suggest-multi/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-habit.zhou-keyword-suggest-multi", "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/habit.zhou~keyword-suggest-multi/runs": { "post": { "operationId": "runs-sync-habit.zhou-keyword-suggest-multi", "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/habit.zhou~keyword-suggest-multi/run-sync": { "post": { "operationId": "run-sync-habit.zhou-keyword-suggest-multi", "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", "country" ], "properties": { "seeds": { "title": "Seed keywords", "minItems": 1, "maxItems": 50, "uniqueItems": true, "type": "array", "description": "1–50 seed keywords to fetch suggestions for.", "items": { "type": "string" } }, "country": { "title": "Country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "ISO 3166-1 alpha-2 country code (e.g. US, DE, JP, CN)." }, "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Subset of search engines to query. Defaults to all nine.", "items": { "type": "string" } }, "expansionSlices": { "title": "Expansion slices", "uniqueItems": true, "type": "array", "description": "A-Z / question / preposition / comparison / prefix-alphabet expansion. Empty = no expansion.", "items": { "type": "string" } }, "maxRequestsPerRun": { "title": "Max requests per run", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard cap on generated requests. If exceeded, tuples are truncated round-robin by seed." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Global max parallel HTTP requests." }, "summaryTopN": { "title": "Top-N suggestions per seed", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Cap on topSuggestions per seed in SUMMARY.json. 0 disables topSuggestions." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration." } } }, "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 } } } } } } } } } } ```