Etsy Keyword Research Tool

Get the exact autocomplete suggestions Etsy's own search box shows shoppers — the same dropdown you see typing into etsy.com/search, pulled programmatically for as many seed terms as you want, in a single run.

No proxy setup required. No captcha-solving service needed. Proxies are bundled — just provide seed keywords and run.

Pricing: $2.65 per 1,000 suggestions. No per-run start fee, no compute charges. You pay for saved suggestions and nothing else. Duplicates are dropped before they reach your dataset, so you never pay for the same keyword twice.

Quick start

{
  "keywords": ["candle", "mug", "gift"]
}

Three seeds, each expanded across the alphabet — roughly 350–380 suggestions per seed, in seconds.

Why this one

Batch your seeds. Pass an array of keywords and get them all in one run. Most Etsy keyword actors take a single keyword per run, which means a separate run — and a separate start fee — for every term you want to research.

No start fee. Runs that charge a flat fee before returning anything punish exactly the workflow keyword research demands: many small, exploratory runs. We charge per saved suggestion, full stop.

Long-tail expansion on by default. Each seed is also queried followed by every letter (gift a, gift b, …) and the dropdowns are merged. It's the trick power users do by hand, and it turns gift from 14 suggestions into 372. Set expandPrefixes: false if you only want the seed's own dropdown.

Specific seeds expand too. handmade candle yields 238 suggestions, custom dog painting yields 271 — 14–27× the base dropdown, whether your seed is one word or four. Many autocomplete scrapers return nothing at all for a multi-word prefix; this one matches what Etsy's own search box shows a shopper mid-type.

Spend caps that actually bind, on by default. maxTotalResults defaults to 2000 suggestions, so a run can never surprise you no matter how many seeds you paste in. maxSuggestionsPerSeed bounds each seed instead. Rows beyond a cap are never saved and never billed — you know your ceiling before you start.

Every language, no configuration. Etsy's autocomplete completes the phrase you type, against a global index. Seed it with kerze and you get kerzenständer gold, kerzenhalter wand; seed it with cadeau and you get cadeau nounou, cadeau personnalisé. Nothing to configure — the language of your seed is the language of your results.

What you get on every row

keyword — the seed term you provided.

suggestion — the exact autocomplete string Etsy's search box would show.

rank — 1-indexed emission order within the seed. A stable sort key, not a score.

source_rank — 1-indexed position within its own dropdown, i.e. Etsy's ordering. candle art is Etsy's #1 suggestion for candle a, so its source_rank is 1 even though it's the 14th row of the seed. This is the relevance signal — sort by it to find the strongest term surfaced by each query.

search_url — a ready-to-click Etsy search URL for that suggestion.

prefix — the expansion character that surfaced this suggestion (empty for the seed's own dropdown; only meaningful when prefix expansion is on).

source_query — the exact query sent to Etsy that first surfaced this suggestion (the seed itself, or e.g. handmade candle a).

scraped_at — UTC timestamp.

What you control

Field	Default	Description
keywords	—	Seed terms to expand, any number, batched in one run
expandPrefixes	true	Also query each seed followed by every expansion character (gift a, gift b, …) and merge the dropdowns — 14–27× more long-tail per seed. Set to false for just the seed's own dropdown
prefixCharacters	a–z	Characters appended during expansion; edit to add digits or narrow the set
maxSuggestionsPerSeed	—	Optional cap on deduplicated suggestions kept per seed — a cost guardrail for expansion
maxTotalResults	2000	Cap on suggestions saved across the whole run. Once hit, remaining queries are skipped — rows beyond the cap are never saved or billed. Raise it for large sweeps

Use cases

Deep long-tail sweeps. The default. Each seed is pulled followed by every letter (mushroom lamp a, mushroom lamp b, …) — the same trick power users do by hand, harvesting 14–27× more suggestions per seed in one run.

{
  "keywords": ["mushroom lamp", "cottagecore decor", "linen dress"]
}

Just the dropdown. Turn expansion off when you want exactly what a shopper sees when they type your seed, and nothing more.

{
  "keywords": ["mushroom lamp"],
  "expandPrefixes": false
}

Bounded spend. maxTotalResults caps the run and defaults to 2000. Raise it for a big sweep, or lower it to hold a run to a known budget.

{
  "keywords": ["mushroom lamp", "cottagecore decor", "linen dress"],
  "maxTotalResults": 500
}

Across many seeds, prefer maxSuggestionsPerSeed — seeds run in parallel and race for the run-wide budget, so maxTotalResults alone doesn't guarantee each seed gets an equal share.

{
  "keywords": ["lamp", "decor", "dress", "candle", "mug"],
  "maxSuggestionsPerSeed": 100
}

Find the strongest term per prefix. Sort by source_rank and filter to 1 to get Etsy's top suggestion for every query it answered — 27 high-confidence terms per expanded seed, one per letter of the alphabet.

Listing title & tag research. Rank-ordered suggestions double as a ready-made source of search terms for titles and tags — pulled straight from what shoppers actually type.

Non-English markets. Seed in the language you sell in. Etsy completes the phrase you give it, so German seeds return German long-tail and French seeds return French — no locale setting, no separate run per market.

{
  "keywords": ["kerze", "geschenk für sie", "cadeau personnalisé"]
}

Bulk seed sweeps. Run dozens of seed variants in one call — each gets its own rank-ordered suggestion set and a per-seed summary.

Output

Results land in the default dataset — export as JSON, CSV, Excel, or JSONL from the Apify console or via API. The dataset holds only suggestion rows (one per suggestion).

Per-seed status is written to the Key-Value Store under the key RUN_REPORT, a single object with a seeds array (keyword, queries — how many autocomplete queries the seed fanned out into, suggestions_count, completed — false if any of the seed's queries permanently failed after retries) plus a summary of run totals. If a seed came back incomplete, you'll know which one — rather than silently receiving fewer keywords than you asked for. Keeping it out of the dataset means the dataset stays billable-per-suggestion with no meta rows mixed in.

Sample row

{
  "keyword": "candle",
  "suggestion": "candle art",
  "rank": 14,
  "source_rank": 1,
  "search_url": "https://www.etsy.com/search?q=candle+art",
  "prefix": "a",
  "source_query": "candle a",
  "scraped_at": "2026-07-05T12:00:00.000000+00:00"
}

The 14th row of the candle seed, and Etsy's first suggestion for candle a.

What this Actor does not do

It returns Etsy's autocomplete suggestions — the real search phrases Etsy proposes to shoppers. It does not estimate search volume, competition scores, or listing performance. Those numbers are not published by Etsy, and tools that display them are modelling, not measuring.

---

⚠️ Unofficial. This actor is not affiliated with, endorsed by, or sponsored by Etsy, Inc. "Etsy" is a trademark of Etsy, Inc., used here for descriptive purposes only.