Etsy Keyword Suggestions - what Etsy's search box completes
Pricing
Pay per event
Etsy Keyword Suggestions - what Etsy's search box completes
Etsy's own search suggestions for your seed keywords, from the public endpoint the etsy.com search box uses: every completion, expanded letter by letter (seed + a-z, 0-9) and optionally one level deep. One row per unique suggestion with its seed, query and position. No login, no invented volumes.
Pricing
Pay per event
Rating
0.0
(0)
Developer
Stephen Psaradellis
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
7 hours ago
Last modified
Categories
Share
Etsy Keyword Suggestions
What Etsy's own search box completes your keywords to, as a dataset: one row per unique suggestion, with the seed it came from, the exact query that produced it, and its position in Etsy's list.
Etsy completes a partial query from what buyers actually type. That makes
its suggestions the closest public thing to a demand signal Etsy offers: a
phrase Etsy completes is a phrase buyers search, and a seed with no
completions is a phrase nobody types. This actor reads the public
suggestions endpoint the etsy.com search box calls, expands every seed
letter by letter (candle a, candle b, ... candle 9) to surface the long
tail, and can go one level deeper by querying every suggestion it found as a
seed of its own.
What you get
One dataset row per unique suggestion:
| field | meaning |
|---|---|
keyword | the suggestion, exactly as Etsy returned it |
seed | the seed keyword it was reached from |
query | the exact query sent to Etsy that returned it |
position | 1-based position in that query's list (Etsy's order) |
depth | 0 seed query, 1 letter-by-letter expansion, 2 discovered suggestion queried as a seed |
categories | category hints Etsy attached, when any |
simplified_queries | Etsy's simplified forms of the query, when any |
read_at | when the query was answered (UTC) |
The key-value store also gets a RUN_SUMMARY: seeds, queries sent, empty
answers, suggestions seen, unique rows pushed, and what stopped the run if a
cap or a block did.
Input
- keywords - the seeds to expand. One query each, plus 36 more per seed when expanding.
- expand - also query each seed followed by a space and each of a-z, 0-9. On by default. This is where the long tail comes from.
- depth - 0 seeds only; 1 seeds plus expansion; 2 also query every suggestion found as its own seed, one level deep.
- maxQueries, maxSuggestions - caps on requests sent and unique rows pushed. Defaults 2,000 and 10,000; 0 is unbounded.
- concurrency, timeoutSecs - how the requests are paced.
Pricing
Pay per event. query is charged once per request sent to Etsy;
suggestion-row once per unique suggestion pushed. A suggestion seen again
under another query is not charged again, and an empty answer costs one
query and no rows. With the defaults, 10 seeds at depth 1 is at most 370
queries and about 1,500 rows.
What it does not do
It does not sign in, does not open listing or shop pages, and does not invent search volumes - Etsy publishes none, and the position within one query's list is recorded as an ordinal, nothing more. Suggestions vary by season and region; the rows say when they were read.
Running locally
Input is read from storage/key_value_stores/default/INPUT.json; the
dataset lands under storage/datasets/default/.
