# 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:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** E-commerce, Marketing
- **Stats:** 2 total users, 1 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 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 `<seed> 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.

**Do I need any setup or a login?**
No setup and no login. Just add the actor, enter seed keywords, and run.

**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. </content>

# Actor input Schema

## `keywords` (type: `array`):

Seed keywords to expand into Amazon search suggestions.

## `alphabetSoup` (type: `boolean`):

Also query "<seed> a" … "<seed> 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"
}
```

# Actor output Schema

## `results` (type: `string`):

The scraped results as dataset items.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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 <APIFY_API_TOKEN>` 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/XQtQ0gtvLcjRTfQff/openapi.json