# Amazon Keywords (`s-r/amazon-keywords`) Actor

- **URL**: https://apify.com/s-r/amazon-keywords.md
- **Developed by:** [SR](https://apify.com/s-r) (community)
- **Categories:** E-commerce, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 suggestion extracteds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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 Keyword Scraper: Autocomplete Suggestions and Long-Tails

Hosted **amazon keyword research** that returns the same autocomplete suggestions Amazon's own search box shows real shoppers, as structured JSON, with no captcha-solving, proxy-rotation, or site-update maintenance you'd otherwise own. Run it from the Apify Store with one click, or call it from your own service via the Apify API. Pay per suggestion, not per month.

If you've been searching for an **amazon keyword search tool** that gives you raw, machine-readable data instead of yet another dashboard you have to log into, this Actor is it.

### What you get

- **Live Amazon autocomplete suggestions**, every prefix expands into 10–11 buyer-intent keywords from Amazon's own search box, the same data Helium 10 and Jungle Scout charge $99–$449/month to surface.
- **10 marketplaces covered**, US, UK, DE, FR, IT, ES, NL, CA, JP, AU.
- **Department targeting**, Amazon search alias support (`aps` for all departments, `electronics`, `fashion`, `kitchen`, etc.).
- **Structured JSON output**, clean records with rank, keyword, suggestion type, and Amazon's internal strategy id.
- **Pay only for what you scrape**, pricing scales with the number of suggestions returned. No subscription, no per-seat fees.

### Why use this amazon keyword research tool instead of Helium 10

Helium 10 is the dominant **amazon keyword research tool** in the market, but it has trade-offs this Apify Actor avoids:

- **No subscription lock-in.** Helium 10 typically requires a monthly contract starting at $99–$449/month. This Actor charges per suggestion, you can spend $5 on a one-off competitive audit and walk away.
- **Direct dataset access.** Instead of clicking through a dashboard UI to copy data, you get a machine-readable JSON dataset on every run. Pipe it straight into BigQuery, Snowflake, or your warehouse.
- **No per-seat pricing.** Anyone on your team can call the Actor's API; pricing is based on usage, not seats.
- **Same source data.** Helium 10 and Jungle Scout both source autocomplete from the same Amazon `completion.amazon.com` endpoint, they wrap it in a UI and a search-volume estimator. If you only need the keywords themselves (and you're estimating volume separately, e.g. via Google Ads Keyword Planner), the Actor delivers the same input at a fraction of the cost.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `prefix` | string | **required** | Search prefix Amazon should auto-complete (e.g. `iphone case`). |
| `marketplace` | string | `US` | Amazon country marketplace. One of US, UK, DE, FR, IT, ES, NL, CA, JP, AU. |
| `alias` | string | `aps` | Amazon search alias (`aps` = all departments, `electronics`, `fashion`, `kitchen`, `automotive`, etc.). |

### Output

Every run pushes results to the Apify dataset as JSON records, one per autocomplete suggestion:

```json
{
  "rank": 1,
  "keyword": "iphone 17 pro max case",
  "type": "KEYWORD",
  "strategy": "organic",
  "prefix": "iphone",
  "marketplace": "US",
  "alias": "aps",
  "fetched_in_seconds": 0.31
}
```

You can:

- **Download** the dataset as JSON, JSONL, CSV, or Excel from the Apify console
- **Stream** results via the Apify API for use in your own application
- **Pipe** results to webhooks, S3, BigQuery, or any of Apify's 30+ integrations
- **Diff** today's run against yesterday's to detect new keyword opportunities Amazon shoppers are typing right now

### Use cases for amazon keyword research

#### Sourcing a long-tail keyword list for SEO and PPC

Run the Actor across 50–100 seed prefixes per category. The autocomplete expansions give you the real, current vocabulary Amazon shoppers use, directly usable as a seed list for Google Ads Keyword Planner volume enrichment, Amazon Sponsored Products bidding, or product-listing copy.

#### Competitive listing teardown

For each top-10 ASIN in your category, run the Actor on the dominant words from their title and bullet points. The expansions reveal the long-tails the listing is implicitly targeting, and the long-tails it's missing.

#### Trend monitoring

Schedule daily runs on a fixed prefix list. Diff today vs yesterday: new suggestions reveal emerging product trends and seasonal demand shifts before they show up in Helium 10's weekly-refreshed databases.

#### International expansion research

Run the same prefix across all 10 supported marketplaces. The differences in suggestions reveal which product variants, sizes, brands, and use-cases dominate in each country, critical input for international listing localization.

### How it compares

Most keyword tools are dashboards you log into, with export gated behind a paid plan. This Actor returns the raw Amazon autocomplete suggestions as JSON, ready to pipe into your own pipeline.

| | No account or key | Hosted for you | JSON output | Usage-based, no monthly plan |
|---|---|---|---|---|
| This Actor | Yes | Yes | Yes | Yes |
| Helium 10 Amazon Keyword Tool | No, account | Yes (dashboard) | Dashboard export | Freemium, paid plans |
| keywordtool.io (Amazon) | No, account for full data | Yes (dashboard) | Export on paid plan | Subscription |
| SellerApp (Chrome extension) | Install and account | Runs in your browser | Dashboard | Freemium |

### FAQ

#### Is this amazon keyword research tool free?

The Actor itself is hosted on Apify with pay-per-suggestion pricing, you only pay for the autocomplete suggestions you actually receive. There's no monthly subscription and no minimum spend. The first few runs typically cost less than a coffee.

#### What's the best amazon keyword research tool for my use case?

For non-coders who want a managed dashboard with built-in volume estimation and rank tracking, Helium 10 or Jungle Scout are the right choice. For developers, growth marketers, or PPC managers who already have a data pipeline and just need raw autocomplete data feeding into it, this Actor is dramatically cheaper than a full-suite subscription.

#### How does this amazon keyword research tool compare to Helium 10?

Both pull suggestions from the same Amazon autocomplete endpoint. Helium 10 layers volume estimation, rank tracking, listing optimization, and PPC management on top, billed at $99–$449/month. This Actor returns the raw autocomplete data only, billed per suggestion. If you don't need the dashboard, the savings are large.

#### Does this tool work for Amazon Germany, UK, Japan, etc.?

Yes, set the `marketplace` field to the country code. Currently supported: US, UK, DE, FR, IT, ES, NL, CA, JP, AU. The Actor uses each marketplace's native completion endpoint, so suggestions are localized.

#### Can I run this amazon keyword research tool on a schedule?

Yes, Apify has built-in scheduling. Set the Actor to run daily across your seed prefix list and pipe results to your data warehouse. Most teams diff successive runs to surface new long-tail opportunities as Amazon shoppers' vocabulary evolves.

#### What does `alias` do?

Amazon's search box can be scoped to a department. `aps` is "all departments" (the default and broadest set). Setting `alias=electronics` or `alias=fashion` narrows the suggestions to that department's vocabulary, useful when your seed prefix is ambiguous across categories.

### Pricing

This amazon keyword research tool uses Apify's pay-per-event pricing, every successful autocomplete suggestion costs a small fixed amount, so your bill scales linearly with usage. There's no monthly subscription and no minimum spend. See the Apify Store page for the current per-suggestion price; expect a typical 10-suggestion run to cost a few cents.

# Actor input Schema

## `prefix` (type: `string`):

Search prefix Amazon should auto-complete (e.g. 'iphone case').

## `marketplace` (type: `string`):

Amazon country marketplace.

## `alias` (type: `string`):

Amazon search alias (e.g. 'aps' for all departments, 'electronics', 'fashion').

## Actor input object example

```json
{
  "prefix": "iphone",
  "marketplace": "US",
  "alias": "aps"
}
```

# Actor output Schema

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

One row per autocomplete suggestion returned by Amazon's search-box API.

## `output` (type: `string`):

OUTPUT record with the run's counts and status flags.

## `errors` (type: `string`):

Failures with a code and a redacted message. Absent when the run had none.

# 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 = {
    "prefix": "iphone",
    "marketplace": "US",
    "alias": "aps"
};

// Run the Actor and wait for it to finish
const run = await client.actor("s-r/amazon-keywords").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 = {
    "prefix": "iphone",
    "marketplace": "US",
    "alias": "aps",
}

# Run the Actor and wait for it to finish
run = client.actor("s-r/amazon-keywords").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 '{
  "prefix": "iphone",
  "marketplace": "US",
  "alias": "aps"
}' |
apify call s-r/amazon-keywords --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,s-r/amazon-keywords"
        }
    }
}

```

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/gb4LO2OaT43afduBu/builds/BkJPwy1IAambW0Qh4/openapi.json