Skip to main content
These tools research Etsy search keywords and what’s trending. They all need the Search and read Etsy market research permission (research:read) and only read.

​
Try these prompts

Claude and GPT picked the tools shown for these prompts in Alura’s evaluation runs.

​
Good to know

  • Keywords are text. Pass the keyword itself, in any case and spacing; Alura matches it in the chosen language (English by default).
  • Search history needs the Growth plan or above. On other plans the call is refused before anything is charged.
  • Average monthly sales for a keyword is always empty for now. Keyword market explains why.
  • Trending covers products, shops and English keywords. See Trending for how items qualify.

​
Tools

​
get_keyword_metrics

Get keyword metrics. Get Etsy keyword research metrics for one or more keywords (up to 50) in one language: Alura’s estimated monthly Etsy searches, Google searches, competition level and competing listings, 3-month and year-over-year search trend, average price and estimated monthly sales. Use it to compare keyword ideas or check a keyword before using it in a listing. Keywords Alura does not have come back in unfetched (with a code and retry_after), free.
  • Cost of get_keyword_metrics: 1 API credit per item returned, or 1 API credit per call.
  • Behavior: Read-only: changes nothing. Returns public Etsy data.
  • Scope: research:read (search and read Etsy market research).
  • REST: GET /v1/research/keywords, GET /v1/research/keywords/{id}.
Example arguments
Get related keywords. Get Etsy keywords related to a keyword, in one language, with Alura’s metrics for each: estimated monthly Etsy searches, Google searches, competition level and competing listings, 3-month and year-over-year trend, average price and estimated monthly sales. Most searched first, up to 25 per page; pass next_cursor back as cursor for more. Use it to find more keyword ideas around one. A keyword Alura does not have comes back in unfetched (with a code and retry_after), free. Example arguments

​
get_keyword_top_results

Get a keyword’s top products or shops. Get the best-selling Etsy products (other sellers’ listings) or the top shops for a keyword (kind: products or shops), in one language: product summaries (price, category, reviews, estimated sales and revenue, listing score) or shop summaries (country, category, Etsy’s sales count, estimated monthly sales and revenue, reviews, active listings). Products: every word of the keyword in the title, or the keyword as a tag, most estimated sales first. Shops: the shops behind the keyword’s 500 best-selling products, ranked by those products’ sales. Up to 50 per page; pass next_cursor back as cursor for more. Use it to see who wins a keyword before targeting it. A keyword Alura does not have comes back in unfetched (with a code and retry_after), free. Example arguments

​
get_keyword_history

Get keyword search history. Get a keyword’s monthly search volume on Etsy (Alura’s estimate) and Google, for every completed month Alura has, in one language. Use it to see seasonality and long-term demand before targeting a keyword. A month without a figure is null. Needs a plan that includes history. A keyword Alura does not have comes back in unfetched (with a code and retry_after), free.
  • Cost of get_keyword_history: 1 API credit per call, or 1 API credit per item returned.
  • Behavior: Read-only: changes nothing. Returns public Etsy data.
  • Scope: research:read (search and read Etsy market research).
  • Plan: Growth or above. On other plans the call is refused with plan_required and costs nothing.
  • REST: GET /v1/research/keywords/{id}/history, GET /v1/research/keywords.
Example arguments
Get trending on Etsy. Get what is trending on Etsy (kind). products and shops: rising (default; estimated sales grew the most over the last 3 completed months against the 3 before, with at least 30 estimated sales a month) or new (listed or opened in the last 90 days, with at least 10 estimated sales a month, best sellers first), as product or shop summaries with sales.est_trend_3m and sales.est_last_month; summary.trend_window names the months compared. Only items Alura has refreshed recently can qualify, so coverage grows as Alura refreshes more of Etsy: an item missing from trending is not proof that it is not rising. keywords: the Etsy keywords whose search volume rose the most over the last 3 months against the 3 before, biggest rise first, with Alura’s metrics for each (estimated monthly Etsy searches, Google searches, competition, 3-month and year-over-year trend, average price, estimated monthly sales). Up to 50 per page; pass next_cursor back as cursor for more. Use it when the user asks what is rising on Etsy or wants new product ideas. Example arguments