Amazon Search Suggestions Scraper

What does this Actor do?

Amazon Search Suggestions Scraper harvests Amazon's native autocomplete suggestions — the exact phrases shoppers see in the search box — across 18 verified marketplaces. No browser involved: the Actor talks to Amazon's own suggestions endpoint over HTTP with TLS impersonation, which makes it sub-second per keyword and extremely cheap to run. Batch unlimited seed keywords, expand them with alphabet/digit suffixes or buyer modifiers, and get a deduplicated keyword list with source tracking.

Why this Actor?

• Real shopper language — autocomplete reflects what people actually type, in the marketplace's native language.
• Batch + expansion built in — one seed with alphabet expansion becomes up to 37 calls and hundreds of long-tail keywords; every item records which expansions surfaced it (matchedBy) and its best rank.
• You pay per unique suggestion — deduplication happens before charging; failed calls are never charged.
• Fast — no browser: a 100-keyword run finishes in seconds to minutes, not tens of minutes.

Quick start

{
  "prefixes": ["usb c cable", "yoga mat"],
  "marketplace": "com",
  "expansion": "alphabet"
}

Single seed without the array: {"query": "laptop", "marketplace": "com"}.

Input reference

Field	Type	Default	Description
prefixes	string[]	—	Seed keywords (batch freely)
query	string	—	Single-seed convenience field
marketplace	string	com	One of 18: de, com, co.uk, fr, it, es, ca, com.au, co.jp, in, nl, se, pl, be, mx, br, ae, sa
expansion	string	none	none · alphabet (a–z, 0–9 suffixes) · modifiers (buyer modifiers like "for", "best", "kids") · alphabet+modifiers
proxyConfiguration	object	Apify Residential	Proxy settings; custom proxyUrls supported
proxiesByMarketplace	object	—	Geo-pinned proxies per marketplace — tried first, ahead of the bundled pool and the Apify tiers
apifyProxyFallback	boolean	true	After the own pool, also try Apify datacenter then Apify residential (geo-targeted) on bot-detection/transport failures

Output

One dataset item per unique suggestion:

{
  "seed": "usb c cable",
  "suggestion": "usb c cable 2m",
  "rank": 1,
  "matchedBy": ["seed", "expand:2"],
  "variantCount": 2,
  "marketplace": "com",
  "scrapedAt": "2026-08-17T09:00:00Z"
}

Field	Meaning
seed	Your input keyword
suggestion	The autocomplete phrase, verbatim
rank	Best (lowest) position seen across the calls that surfaced it
matchedBy	Which calls produced it — seed, expand:x, or modifier:x — measures suggestion coverage breadth
variantCount	Number of entries in matchedBy — how many distinct calls surfaced it (popularity proxy)
marketplace, scrapedAt	Provenance

RUN_SUMMARY (key-value store) reports unique counts and any failed calls per run — failures are visible, never billed.

Pricing

Pay per unique suggestion (suggestion event). Alphabet expansion of one seed ≈ 37 calls ≈ typically 150–300 unique suggestions. See the Pricing tab for the current price.

Use with AI agents (MCP)

Actor identity: cyprusapi/amazon-search-suggestions. Tool description: get Amazon autocomplete keyword suggestions for seed terms across 18 marketplaces, with optional alphabet/modifier expansion, deduplicated with source tracking.

Example prompt: "Give me Amazon.com long-tail keywords for 'yoga mat' with alphabet expansion." → input: {"query": "yoga mat", "marketplace": "com", "expansion": "alphabet"}

Pairs naturally with cyprusapi/amazon-search (check which products rank for your harvested keywords) and cyprusapi/amazon-bestsellers (validate demand in the category).

FAQ & limitations

• Amazon returns up to ~10–11 suggestions per call — that's the platform's own limit; expansion modes exist to go deeper.
• Suggestions are marketplace-language native (jp → Japanese, etc.).
• Occasional empty responses for nonsense seeds are normal, not errors.
• Proxy tier chain per call: your proxiesByMarketplace pool first, then the bundled pool (per-Actor named KVS proxy-pool-amazon-search-suggestions, record pool — works under LIMITED_PERMISSIONS; the user input always wins), then — with apifyProxyFallback on — Apify datacenter, then Apify residential. Retries only on bot detection/transport.
• Legality: the endpoint is public and powers amazon's own search box; comply with Amazon's ToS and applicable law.
• Issues tab is open — marketplace/selector maintenance is part of the product.