# Amazon Autocomplete Keyword Scraper (`hipersoft/amazon-autocomplete-scraper`) Actor Generate Amazon product keyword ideas from Amazon's search autocomplete: alphabet-soup expansion, per marketplace (US/UK/DE/…) and department. Ideal for Amazon SEO, PPC and product research. Clean, no setup. - **URL**: https://apify.com/hipersoft/amazon-autocomplete-scraper.md - **Developed by:** [Hipersoft](https://apify.com/hipersoft) (community) - **Categories:** E-commerce, Marketing - **Features:** Limited permissions - **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.00025 / keyword scraped This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Amazon Autocomplete Scraper — Keywords, Suggestions & Search Terms Pull real buyer keywords straight from **Amazon's search box**. The **Amazon autocomplete scraper** takes your seed keywords, expands them with alphabet-soup modifiers, and returns clean, structured **keyword suggestions** — deduplicated and ranked by the order Amazon shows them — as JSON, CSV, Excel or XML. Built for Amazon sellers, PPC managers and product researchers who want to know exactly what shoppers type. Fast and reliable. ![Amazon Autocomplete Scraper input — seed keywords, marketplace and department in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/amazon-autocomplete-scraper-input.png?v=5) ### What does Amazon Autocomplete Scraper do? The Amazon autocomplete scraper collects the search suggestions Amazon serves for your seed keywords across 11 marketplaces. Turn on alphabet-soup expansion to query each seed with `a`–`z` and `0`–`9` modifiers and surface dozens of long-tail product keywords per seed, each tagged with its rank and the expansion that produced it. Export everything to JSON, CSV, Excel or XML. ### What data can you scrape from Amazon Autocomplete? | Data point | Description | |------------|-------------| | 🔤 Keyword | The suggested search term shoppers see | | 🌱 Seed keyword | The seed that produced the suggestion | | 🔡 Expansion | The alphabet-soup modifier that surfaced it | | 🎯 Position | Rank of the suggestion in Amazon's list | | 🌍 Marketplace | The Amazon marketplace queried | | 🏬 Category | The department alias the suggestions were scoped to | ### What you get ![Amazon Autocomplete Scraper output example — keyword, seed, expansion, position and marketplace as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/amazon-autocomplete-scraper-output.png?v=5) Each row is one unique keyword suggestion: ```json { "keyword": "wireless earbuds bluetooth", "seedKeyword": "wireless earbuds", "expansion": "alphabet:b", "position": 3, "marketplace": "us", "category": "aps" } ``` #### Output schema | Field | Type | Description | |-------|------|-------------| | `keyword` | string | The suggested Amazon search keyword | | `seedKeyword` | string | The seed keyword this suggestion was expanded from | | `expansion` | string | The alphabet-soup modifier that produced the suggestion | | `position` | integer | Rank of the suggestion within Amazon's list | | `marketplace` | string | Amazon marketplace the suggestion came from (e.g. `us`, `uk`) | | `category` | string | Department alias the suggestions were scoped to | ### Use cases - **Amazon SEO** — build long-tail keyword lists to optimize product titles and listings. - **Sponsored Products / PPC** — discover high-intent terms for ad campaigns. - **Product research** — validate ideas by seeing what buyers actually search for. - **Marketplace comparison** — see how suggestions differ across 11 marketplaces. - **Content & niche discovery** — find sub-topics and adjacent product keywords. - **Keyword tracking** — monitor how top suggestions change over time. ### How to scrape Amazon autocomplete data 1. Add the **Amazon Autocomplete Scraper** to your Apify account. 2. Enter one or more **seed keywords**. 3. Turn on **alphabet-soup expansion** for many more long-tail keywords. 4. Choose a **marketplace** and, optionally, a **department** to scope the suggestions. 5. Click **Run**, then export the results as JSON, CSV, Excel or XML — or pull them via the Apify API. ### Input ```json { "keywords": ["wireless earbuds", "yoga mat"], "alphabetSoup": true, "marketplace": "us", "category": "electronics" } ``` | Field | Type | Description | |-------|------|-------------| | `keywords` | array | Seed keywords to expand into Amazon suggestions (required). | | `alphabetSoup` | boolean | Also query ` a`…`z` and `0`–`9` for long-tail keywords. Default `true`. | | `marketplace` | string | Amazon marketplace: `us`, `uk`, `de`, `fr`, `it`, `es`, `ca`, `jp`, `in`, `au`, `mx`. Default `us`. | | `category` | string | Department alias to scope suggestions, e.g. `aps`, `electronics`, `beauty`. Default `aps`. | ### Need more Amazon and keyword data? - [Amazon Product Scraper](https://apify.com/hipersoft/amazon-product-scraper) - [Google Autocomplete Scraper](https://apify.com/hipersoft/google-autocomplete-scraper) - [eBay Scraper](https://apify.com/hipersoft/ebay-scraper) - [Shopify Product Scraper](https://apify.com/hipersoft/shopify-product-scraper) - [Google Search Scraper](https://apify.com/hipersoft/google-search-scraper) ### FAQ **How many keywords can I collect?** As many as you like — pass multiple seeds and turn on alphabet-soup expansion to multiply the suggestions per seed. **Which marketplaces are supported?** 11 marketplaces: `us`, `uk`, `de`, `fr`, `it`, `es`, `ca`, `jp`, `in`, `au` and `mx`. **Which export formats are supported?** JSON, CSV, Excel and XML, plus the Apify API and dataset views. **Can I scope suggestions to a department?** Yes — set a `category` (department alias) such as `electronics`, `beauty` or `books`. **How does billing work?** You pay per item you collect — no subscriptions and no minimums. **Can I connect it to other tools?** The Amazon Autocomplete Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes. **Is it legal?** The scraper returns only the public suggestions Amazon serves to any shopper. You are responsible for how you use the data and for complying with Amazon's terms. ### Related Actors - [Google Autocomplete Scraper](https://apify.com/hipersoft/google-autocomplete-scraper) - [Google Search Scraper](https://apify.com/hipersoft/google-search-scraper) - [Google Trends Scraper](https://apify.com/hipersoft/google-trends-scraper) ### Notes Original clean-room implementation. Returns only public suggestion data; you are responsible for compliance with Amazon's terms. Not affiliated with, endorsed by or sponsored by Amazon; Amazon is a trademark of its respective owner. # Actor input Schema ## `keywords` (type: `array`): Seed keywords to expand into Amazon search suggestions. ## `alphabetSoup` (type: `boolean`): Also query " a" … " z" and 0–9 for many more long-tail product keywords. ## `marketplace` (type: `string`): Amazon marketplace to query. ## `category` (type: `string`): Amazon department alias to scope suggestions, e.g. aps (all), electronics, hpc (health), sporting, beauty, toys, books. ## Actor input object example ```json { "keywords": [ "yoga mat", "protein powder" ], "alphabetSoup": true, "marketplace": "us", "category": "aps" } ``` # 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 = { "keywords": [ "wireless earbuds" ] }; // Run the Actor and wait for it to finish const run = await client.actor("hipersoft/amazon-autocomplete-scraper").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 = { "keywords": ["wireless earbuds"] } # Run the Actor and wait for it to finish run = client.actor("hipersoft/amazon-autocomplete-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "wireless earbuds" ] }' | apify call hipersoft/amazon-autocomplete-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/amazon-autocomplete-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/OPP826D8QGB3SH4gS/builds/3OVaYkYIARnzYnaCB/openapi.json