Etsy Keyword Research with Reproducible Listing Evidence

Turn Etsy niche or product seed phrases into a structured shortlist of keyword ideas supported by public indexed listing evidence. Each dataset row represents one deduplicated phrase with the related seeds, distinct listing evidence, source queries, canonical Etsy URLs, confidence, and a transparent opportunity score for listing-title and market research.

Best fit for this Actor

Choose this Actor when your workflow starts with product or niche phrases and needs explainable Etsy keyword ideas. To continue from research into live listing discovery, send a returned keyword to the Etsy Product Search Scraper as its searchQuery, then analyze the resulting listing URLs, titles, prices, shops, and reviews.

A practical listing-research scenario

An Etsy seller starts with a product concept such as ceramic mug. The Actor expands that seed through public indexed listing evidence, ranks deduplicated phrases, and returns the supporting listing URLs and source queries. The seller then reviews the evidence and continues with selected phrases in a listing-search or merchandising workflow.

Quick start input

{
  "seedKeywords": ["ceramic mug"],
  "maxKeywords": 20,
  "maxSearchesPerSeed": 4,
  "expansionCharacters": "abcd",
  "countryCode": "US"
}

maxKeywords controls the maximum number of saved keyword records, while maxSearchesPerSeed and expansionCharacters shape the breadth of the public-index evidence pass.

What data you receive

Field	Meaning
keyword	Candidate phrase extracted from indexed Etsy listing titles
seedKeywords	Input seeds connected to the phrase
evidenceCount	Distinct canonical listing URLs supporting the phrase
opportunityScore	Transparent ordering score based on evidence and phrase specificity
confidence	Qualitative evidence band
sourceType	Public indexed Etsy listing evidence
evidenceUrls	Canonical Etsy listing URLs for review
sourceQueries	Public-index searches that surfaced the evidence
collectedAt, searchUrl	Collection context and a continued Etsy search route

{
  "keyword": "ceramic coffee mug",
  "seedKeywords": ["ceramic mug"],
  "evidenceCount": 2,
  "opportunityScore": 81,
  "confidence": "medium",
  "sourceType": "public_indexed_etsy_listing",
  "evidenceUrls": [
    "https://www.etsy.com/listing/1234567890/ceramic-coffee-mug"
  ],
  "sourceQueries": ["ceramic mug a"],
  "collectedAt": "<ISO-8601 collection time>",
  "searchUrl": "https://www.etsy.com/search?q=ceramic%20coffee%20mug"
}

Run through the Apify API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~etsy-keyword-research-tool/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"seedKeywords":["ceramic mug"],"maxKeywords":20,"maxSearchesPerSeed":4,"countryCode":"US"}'

Read the default dataset for keyword evidence rows and retain evidenceUrls for source review.

Use with AI agents through Apify MCP

Example prompt:

Research Etsy keyword ideas for these product seeds. Return each keyword, confidence, opportunity score, distinct evidence count, source queries, canonical evidence URLs, and collection time. Read the dataset and recommend a focused shortlist with source provenance.

Give the agent clear seed phrases and a bounded keyword scope. Ask it to preserve evidence URLs, explain its shortlist using the returned fields, and report the dataset outcome and Apify cost.

Pricing

This Actor uses Pay per event plus Apify platform usage. A keyword event is associated with an evidence-backed record saved to the dataset. Open the live Pricing tab for current billing details and use maxKeywords or Apify run cost controls to keep the research pass aligned with your budget.

Best results

Provide specific product or niche phrases, use a focused country code for the public-index request route, and review evidenceUrls alongside each returned phrase. Continue with the Etsy Product Search Scraper when listing-level fields support the next decision.

Builder's note

I learned that a keyword suggestion becomes much easier to trust when the record carries the exact listing URLs and source queries that produced it. I built the ranking around distinct evidence and phrase specificity so the dataset explains its ordering instead of presenting an opaque score.

Responsible use

Collect public evidence you are authorized to access and follow applicable laws, Etsy terms, and your organization's marketplace research policies.