collections /etsy /keyword-research-tool
K

Etsy Keyword Research Tool

astravalabs/etsy-keyword-research-tool

Give it broad or specific seed terms and it returns the phrases Etsy's search box suggests to shoppers. Prefix expansion can query each seed with a–z, deduplicate the combined results, and preserve the rank and source query that surfaced every suggestion.

// run this actor

Use the Apify CLI for a quick local run, or the HTTP API from any language or automation platform.

Option 01 / Apify CLICLI docs ↗
apify call astravalabs/etsy-keyword-research-tool --input '{"keywords":["mushroom lamp"],"expandPrefixes":true,"maxTotalResults":2000}'
Option 02 / HTTP API + cURLAPI reference ↗
# Set API token
API_TOKEN=<YOUR_API_TOKEN>

# Prepare Actor input
cat > input.json << 'EOF'
{
  "keywords": [
    "mushroom lamp"
  ],
  "expandPrefixes": true,
  "maxTotalResults": 2000
}
EOF

# Run the Actor using the HTTP API
# Full API reference: https://docs.apify.com/api/v2
curl "https://api.apify.com/v2/acts/astravalabs~etsy-keyword-research-tool/runs?token=$API_TOKEN" \
  -X POST \
  -d @input.json \
  -H 'Content-Type: application/json'

// Replace <YOUR_API_TOKEN> before running the cURL example. Keep tokens out of committed files.

inputtypebehavior
keywords *string[]1–50 seed terms to expand.
expandPrefixesbooleanQuery the seed plus every configured prefix character. Default: true.
prefixCharactersstringCharacters used for long-tail expansion. Default: a–z.
maxSuggestionsPerSeedintegerOptional cost cap for each seed.
maxTotalResultsintegerExact whole-run result ceiling. Default: 2000.

// output — 8 top-level fields per suggestion

suggestion
keywordstringOriginal seed term
suggestionstringExact Etsy autocomplete phrase
rankintEmission order within the seed
source_rankintPosition within its source dropdown
source
search_urlstringReady-to-open Etsy search URL
prefixstringExpansion character that found the phrase
source_querystringExact query sent to Etsy
scraped_atdatetimeUTC collection timestamp

// use cases

  • Deep long-tail keyword discovery
  • Listing title and tag research
  • Non-English market research
  • Bounded bulk seed sweeps

// boundaries

  • Returns Etsy autocomplete suggestions, not search-volume estimates.
  • Rank records dropdown order; it is not a traffic or competition score.
measured performance / 2026-07-05

Prefix expansion typically yields 14–27× more suggestions per seed than the seed dropdown alone.

last tested / 2026-07-18

What “last tested” means

The published input contract, output field list, pricing unit, and documentation were checked against the current actor, and a sample run completed on the date shown. This is a dated product check, not an uptime guarantee; public source behavior can change after testing.

Inspect representative JSON →

// sanitized illustrative values; field names and nesting follow the published output contract

// use in a workflow

// companion actors