Etsy Store Query

SkillSearch

Query Etsy stores with multi-dimensional filters (sales, favorites, reviews, store opening date, country, primary category, Raving/Star ratings). Trigger when user mentions Etsy store, Etsy shop search, Etsy seller, Etsy shop ranking, Etsy weekly sales stores, Etsy stores, or Etsy store query — even if the tool name is not mentioned, as long as the need is to find stores, filter store data, or analyze store performance on Etsy.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Etsy Store Query skill

What this skill tells your AI

The instructions your AI receives, as published by nexscope-ai/nexscope-ecommerce-skills in ecommerce-etsy-store-query/SKILL.md and read by ahel’s review.

Key Points

  • Pagination: page starts at 1; pageSize defaults to 20, maximum 100.
  • Range Parameters: begin* / end* pairs correspond to upstream comma-delimited ranges. Filling only one side means the upstream treats it as "start~" or "~end".
  • Sorting: sortBy only supports 8~11 (8 total sales, 9 weekly sales, 10 review count, 11 favorite count). sortDesc: 1=descending, 0=ascending (do not confuse with the product query interface''s sortDesc).

Script (Optional)

Command-line debugging: python scripts/etsy_store_query.py ''<JSON>'' (requires NEXSCOPE_API_KEY). See references/api.md for details.

Reference

Input/output parameter tables are in references/api.md.

Authentication

Set the NEXSCOPE_API_KEY environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.

Credit Consumption

Dynamic pricing: credits consumed = number of stores returned x 1.8. Billed per page of results returned; fetching the next page is essentially a new request, billed again based on the new page''s result count.

Important: This skill''s cost scales dynamically and may consume a significant number of credits in a single call. You must warn the user and let them decide whether to continue.

Signals

GitHub stars
67
Forks
9
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
ecommerce-etsy-store-query
Source
github.com/nexscope-ai/nexscope-ecommerce-skills