Etsy Product Research
Etsy Product Query MCP
Filter Etsy products by keyword, URL, price, sales, favorites, reviews, listing date, category, product type, and marketplace. Available via REST API or MCP.
Etsy Product Query AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Find Etsy Products Matching My Selection Criteria
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Show the available results and clearly identify missing information.
2. Research In A Selected Currency
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Present the available monetary values in [my selected currency], using [my supplied conversion rate] only if the tool requires one. Do not compare amounts in different currencies.
3. Continue The Results Within A Page Limit
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.
4. Prioritize The Results For Review
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period.
5. Find Products By Favorite Count
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Keep products within [my favorite count range] and summarize the matching records.
6. Find Matches By Favorites Weekly
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen favorites weekly range]. Keep the lower and upper bounds consistent and show only the matching records.
7. Find Products By Price
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Keep products within [my price range] and summarize the matching records.
8. Find Products By Review Count
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Keep products within [my review count range] and summarize the matching records.
9. Find Matches By Reviews Weekly
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen reviews weekly range]. Keep the lower and upper bounds consistent and show only the matching records.
10. Find Matches By Sales Amount
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Limit results to [my chosen sales amount range]. Keep the lower and upper bounds consistent and show only the matching records.
11. Find Products By Weekly Sales
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Keep products within [my weekly sales range] and summarize the matching records.
12. Find Products In An Etsy Category
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected product category id , see the category query api] to narrow the results. Report only what the selected records support.
13. Find Etsy Bestsellers
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected the product is a bestseller] to narrow the results. Report only what the selected records support.
14. Find Etsy Pick Items
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected the product is a pick item] to narrow the results. Report only what the selected records support.
15. Find Highly Praised Stores Or Products
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Apply [my preference for the raving classification] when reviewing the results. Summarize only the returned records.
16. Find Recently Listed Products
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected listing time no earlier than this date] to narrow the results. Report only what the selected records support.
17. Choose An Etsy Product Type
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Find [handmade, vintage, digital, custom or other] products, using the product types I select. Summarize only the returned records.
18. Find Products By Listing Status
Prompt: Find Etsy products matching my selection criteria for [search phrase] in [target marketplace]. Use [my selected product status (example] to narrow the results. Report only what the selected records support.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_etsy_product_queryhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "etsy-product-query-1",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_product_query",
"arguments": {
"page": 1,
"pageSize": 20,
"searchKey": "phone case"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
beginFavorites | integer | optional | Favorite count (start), combined with end value to form the upstream favorites range Example: 1 |
beginFavoritesWeekly | integer | optional | Weekly new favorites (start), combined with end value to form the upstream favorites_weekly range Example: 1 |
beginPrice | number | optional | Price (start), combined with end price to form the upstream price range (e.g., 20~100). When only one side is provided, the upstream returns start~ or ~end Example: 1 |
beginReviews | integer | optional | Review count (start), combined with end value to form the upstream reviews range Example: 1 |
beginReviewsWeekly | integer | optional | Weekly new reviews (start), combined with end value to form the upstream reviews_weekly range Example: 1 |
beginSales | integer | optional | Total sales (start), combined with end value to form the upstream sales range Example: 1 |
beginSalesWeekly | integer | optional | Weekly sales (start), combined with end value to form the upstream sales_weekly range (e.g., 1~100) Example: 1 |
category | string | optional | Product category ID (single category), see the Category Query API |
country | string | optional | Shipping country |
currencyCode | string | optional | Currency code, default USD Example: USD |
endFavorites | integer | optional | Favorite count (end) Example: 1 |
endFavoritesWeekly | integer | optional | Weekly new favorites (end) Example: 1 |
endPrice | number | optional | Price (end), combined with start price to form the upstream price range Example: 1 |
endReviews | integer | optional | Review count (end) Example: 1 |
endReviewsWeekly | integer | optional | Weekly new reviews (end) Example: 1 |
endSales | integer | optional | Total sales (end) Example: 1 |
endSalesWeekly | integer | optional | Weekly sales (end) Example: 1 |
isBestsell | integer | optional | Whether the product is a bestseller Example: 1 |
isPick | integer | optional | Whether the product is a Pick item Example: 1 |
isRaving | integer | optional | Whether the product is a Raving item Example: 1 |
listedTime | string | optional | Listing time no earlier than this date (YYYY-MM-DD) |
page | integer | optional | Page number (starting from 1) Example: 1 |
pageSize | integer | optional | Items per page, default 20, max 100, recommended not to exceed 50 Example: 20 |
productType | string | optional | Product type, comma-separated for multiple: 1=Handmade 2=Vintage 3=Digital 4=Custom 9=Other |
searchKey | string | optional | Search keyword or Etsy product URL |
sortBy | integer | optional | Sort field (corresponds to upstream sort_by, values 1~6) Example: 1 |
sortDesc | integer | optional | Sort direction (corresponds to upstream desc). Schema example: descending 1, ascending 2 (encoding differs from store query's sortDesc) Example: 1 |
status | integer | optional | Product status (example: 1=active, 0=inactive) Example: 1 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Number of records (this page returns the number of records to facilitate alignment with the length of the list) |
sourceType | string | optional | Source type: etsy |
columns | array | optional | Rendered columns |
costToken | integer | optional | Token consumption (estimated based on the number of items returned on this page) |
productNum | integer | optional | Total number of eligible products (upstream product_num) |
title | string | optional | Title |
type | string | optional | Rendering style |
products | array | optional | Etsy product listings |
category | string | optional | Category name |
favorites | integer | optional | Number of collections |
favoritesWeekly | integer | optional | Number of new favorites per week |
imageUrl | string | optional | Main image URL |
isBestsell | integer | optional | Best seller or not: 1=yes |
isPick | integer | optional | Whether to Pick: 1=Yes |
isRaving | integer | optional | Whether Raving: 1=Yes |
price | number | optional | price |
productUrl | string | optional | Product link |
releaseTime | string | optional | Shelf/release time |
reviews | integer | optional | Number of comments |
reviewsWeekly | integer | optional | New comments per week |
salesTotal | integer | optional | total sales |
salesWeekly | integer | optional | Weekly sales |
shipsFrom | string | optional | Shipping country |
status | integer | optional | Product status: 1=on the shelves, 0=off the shelves |
storeName | string | optional | Store name |
tags | string | optional | tag |
title | string | optional | Product title |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find Etsy products matching my selection criteria. Use “kitchen organizer”.
Example Answer
In the published sample, the first shown record is “Goldfish Bag Holder Crochet Pattern PDF \u2013 Hanging Plastic Bag Dispenser, Kitchen Organizer, Step-by-Step Instructions”. Its reported price is 2.21. Its reported reviews is 5. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"searchKey": "kitchen organizer",
"pageSize": 4
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 4,
"sourceTool": "ehunt_etsy",
"sourceType": "etsy",
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "category",
"sortable": true,
"title": "类目名称"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "价格"
},
{
"filterable": true,
"cellType": "number",
"field": "status",
"sortable": true,
"title": "商品状态:1=上架,0=下架"
},
{
"filterable": true,
"cellType": "number",
"field": "salesWeekly",
"sortable": true,
"title": "周销量"
},
{
"filterable": true,
"cellType": "number",
"field": "salesTotal",
"sortable": true,
"title": "总销量"
},
{
"filterable": true,
"cellType": "number",
"field": "reviews",
"sortable": true,
"title": "评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "favorites",
"sortable": true,
"title": "收藏数"
},
{
"filterable": true,
"cellType": "number",
"field": "isBestsell",
"sortable": true,
"title": "是否畅销:1=是"
},
{
"filterable": true,
"cellType": "number",
"field": "isPick",
"sortable": true,
"title": "是否 Pick:1=是"
},
{
"filterable": true,
"cellType": "number",
"field": "isRaving",
"sortable": true,
"title": "是否 Raving:1=是"
},
{
"filterable": true,
"cellType": "text",
"field": "tags",
"sortable": true,
"title": "标签"
},
{
"filterable": true,
"cellType": "text",
"field": "shipsFrom",
"sortable": true,
"title": "发货国家"
},
{
"filterable": true,
"cellType": "text",
"field": "releaseTime",
"sortable": true,
"title": "上架/发布时间"
},
{
"filterable": true,
"cellType": "text",
"field": "storeName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "productUrl",
"sortable": true,
"title": "商品链接"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "主图 URL"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewsWeekly",
"sortable": true,
"title": "周新增评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "favoritesWeekly",
"sortable": true,
"title": "周新增收藏数"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "来源类型:etsy"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "工具类型:ehunt"
}
],
"productNum": 38375,
"title": "商品查询",
"type": "tableListWorkbenches",
"products": [
{
"favorites": 39,
"releaseTime": "2026-10-04",
"isRaving": 0,
"salesTotal": 35,
"favoritesWeekly": 11,
"salesWeekly": 16,
"title": "Goldfish Bag Holder Crochet Pattern PDF \\u2013 Hanging Plastic Bag Dispenser, Kitchen Organizer, Step-by-Step Instructions",
"isPick": 0,
"tags": "crochet, bag holder pattern, plastic bag holder, grocery bag holder, bag dispenser, fish crochet pattern",
"sourceTool": "ehunt_etsy",
"reviews": 5,
"isBestsell": 1,
"sourceType": "etsy",
"price": 2.21,
"imageUrl": "https://i.etsystatic.com/27927724/r/il/5e197b/8669214893/il_120xN.8669214893_qgci.jpg",
"reviewsWeekly": 0,
"shipsFrom": "United States",
"storeName": "MinimalistPagesshop",
"category": "",
"productUrl": "https://www.etsy.com/listing/4588270304/goldfish-bag-holder-crochet-pattern-pdf",
"status": 1
},
{
"favorites": 249,
"releaseTime": "2026-09-09",
"isRaving": 0,
"salesTotal": 26,
"favoritesWeekly": 47,
"salesWeekly": 13,
"title": "3D Vegetable Fridge Magnet Set, Miniature Fake Food Decor, Cute Cottagecore Kitchen Pin, Realistic Farmhouse Whiteboard Accessory, 12-pack",
"isPick": 0,
"tags": "Vegetable Magnet, 3D Fake Food Magnet, Miniature Veggie Pin, Cottagecore Kitchen, Cute Whiteboard Pin, Farmhouse Desk Art, Realistic Food Decor, Foodie Gift Set, Resin Fridge Magnet, Kitchen Organizer, Mini Pumpkin Garlic, Garden Lover Gift",
"sourceTool": "ehunt_etsy",
"reviews": 1,
"isBestsell": 1,
"sourceType": "etsy",
"price": 15.08,
"imageUrl": "https://i.etsystatic.com/65247252/r/il/4bc2f0/8545845559/il_120xN.8545845559_a0pv.jpg",
"reviewsWeekly": 0,
"shipsFrom": "United States",
"storeName": "IslaMagicHaven",
"category": "",
"productUrl": "https://www.etsy.com/listing/4571829107/3d-vegetable-fridge-magnet-set-miniature",
"status": 1
},
{
"favorites": 292,
"releaseTime": "2026-08-18",
"isRaving": 0,
"salesTotal": 14,
"favoritesWeekly": 0,
"salesWeekly": 13,
"title": "Taco Bell Sauce Packet Organizer with Removable Label and Optional Lid",
"isPick": 0,
"tags": "kitchen utensils, chef tool, taco bell, tacos, hot sauce, sauce packet, cooking organizer, snack tray, snack lid, chip tray, sauce boss, get saucy, viva mas",
"sourceTool": "ehunt_etsy",
"reviews": 2,
"isBestsell": 1,
"sourceType": "etsy",
"price": 15,
"imageUrl": "https://i.etsystatic.com/62911095/r/il/039c54/8447680237/il_120xN.8447680237_blgd.jpg",
"reviewsWeekly": 0,
"shipsFrom": "United States",
"storeName": "PlexiPrintsStudio",
"category": "",
"productUrl": "https://www.etsy.com/listing/4558253831/taco-bell-sauce-packet-organizer-with",
"status": 1
},
{
"favorites": 14764,
"releaseTime": "2024-09-24",
"isRaving": 0,
"salesTotal": 787,
"favoritesWeekly": 107,
"salesWeekly": 12,
"title": "Whale spoon rest, Kitchen gift, Kitchen decor, Weird spoon rest, Fish spoon rest, Ceramic spoon rest, Handmade spoon rest, Whale decor",
"isPick": 0,
"tags": "kitchen decor, spoon rest, kitchen organizer, ceramic spoon rest, ravioli spoon rest, weird spoon rest, handmade spoon rest, speckled spoon rest, kitchen gift, utensil holder, handmade pottery, egg spoon rest, Whale Fish shark",
"sourceTool": "ehunt_etsy",
"reviews": 265,
"isBestsell": 1,
"sourceType": "etsy",
"price": 37,
"imageUrl": "https://i.etsystatic.com/23081770/r/il/4414d3/6298649494/il_120xN.6298649494_kae9.jpg",
"reviewsWeekly": 2,
"shipsFrom": "United States",
"storeName": "LeilyCloud",
"category": "",
"productUrl": "https://www.etsy.com/listing/1799823289/whale-spoon-rest-kitchen-gift-kitchen",
"status": 1
}
]
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "etsy-product-query-example",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_product_query",
"arguments": {
"searchKey": "kitchen organizer",
"pageSize": 4
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "etsy-product-query-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"reviews\":5,\"title\":\"Goldfish Bag Holder Crochet Pattern PDF \\\\u2013 Hanging Plastic Bag Dispenser, Kitchen Organizer, Step-by-Step Instructions\",\"price\":2.21,\"favorites\":39,\"releaseTime\":\"2026-10-04\",\"isRaving\":0,\"salesTotal\":35,\"favoritesWeekly\":11,\"salesWeekly\":16,\"isPick\":0,\"tags\":\"crochet, bag holder pattern, plastic bag holder, grocery bag holder, bag dispenser, fish crochet pattern\",\"isBestsell\":1},{\"reviews\":1,\"title\":\"3D Vegetable Fridge Magnet Set, Miniature Fake Food Decor, Cute Cottagecore Kitchen Pin, Realistic Farmhouse Whiteboard Accessory, 12-pack\",\"price\":15.08,\"favorites\":249,\"releaseTime\":\"2026-09-09\",\"isRaving\":0,\"salesTotal\":26,\"favoritesWeekly\":47,\"salesWeekly\":13,\"isPick\":0,\"tags\":\"Vegetable Magnet, 3D Fake Food Magnet, Miniature Veggie Pin, Cottagecore Kitchen, Cute Whiteboard Pin, Farmhouse Desk Art, Realistic Food Decor, Foodie Gift Set, Resin Fridge Magnet, Kitchen Organizer, Mini Pumpkin Garlic, Garden Lover Gift\",\"isBestsell\":1}],\"title\":\"商品查询\",\"total\":4,\"productNum\":38375}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"reviews": 5,
"title": "Goldfish Bag Holder Crochet Pattern PDF \\u2013 Hanging Plastic Bag Dispenser, Kitchen Organizer, Step-by-Step Instructions",
"price": 2.21,
"favorites": 39,
"releaseTime": "2026-10-04",
"isRaving": 0,
"salesTotal": 35,
"favoritesWeekly": 11,
"salesWeekly": 16,
"isPick": 0,
"tags": "crochet, bag holder pattern, plastic bag holder, grocery bag holder, bag dispenser, fish crochet pattern",
"isBestsell": 1
},
{
"reviews": 1,
"title": "3D Vegetable Fridge Magnet Set, Miniature Fake Food Decor, Cute Cottagecore Kitchen Pin, Realistic Farmhouse Whiteboard Accessory, 12-pack",
"price": 15.08,
"favorites": 249,
"releaseTime": "2026-09-09",
"isRaving": 0,
"salesTotal": 26,
"favoritesWeekly": 47,
"salesWeekly": 13,
"isPick": 0,
"tags": "Vegetable Magnet, 3D Fake Food Magnet, Miniature Veggie Pin, Cottagecore Kitchen, Cute Whiteboard Pin, Farmhouse Desk Art, Realistic Food Decor, Foodie Gift Set, Resin Fridge Magnet, Kitchen Organizer, Mini Pumpkin Garlic, Garden Lover Gift",
"isBestsell": 1
}
],
"title": "商品查询",
"total": 4,
"productNum": 38375
}
},
"isError": false
}
}