ecommerce-etsy-category-search

name	ecommerce.etsy-category-search
description	Search Etsy category data by name, ID, or parent IDs to find category identifiers for product/store filtering. Trigger when user mentions Etsy category, Etsy category ID, Etsy category tree, Etsy category lookup, syncEtsyCategory, or category search — even if the tool name is not mentioned, as long as the need is to find a category ID by keyword in a locally synced Etsy category library.

Etsy Category Search

Key Points

• Required: keyword (substring match against category name, category ID, parentIds).
• Pagination: page starts at 1; pageSize defaults to 50, maximum 200.
• The returned id can be used as the category identifier for Etsy product search / store query category parameters (consistent with the specific tool schema).

Script (Optional)

Command-line debugging: python scripts/etsy_category_search.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 authentication fails (401/402) or you see insufficient balance errors, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to get an API Key or top up credits.

Credit Consumption

Does not consume credits.