Etsy Product Query (ehuntproductQuery)

Key Points

• Pagination: page starts at 1; pageSize defaults to 20, maximum 100 (recommended <= 50).
• Range Parameters: Same approach as the store interface — begin* / end* pairs.
• Sorting: sortBy is 1~6 (upstream sort_by). sortDesc: 1=descending, 2=ascending (different from _ehunt_storeQuery which uses 1/0).
• Product Type productType: 1 Handmade, 2 Vintage, 3 Digital, 4 Custom, 9 Other, use commas for multiple selection.
• Currency: currencyCode defaults to USD.
• Category ID: category is a single category ID; use the category search skill to find the ID first.

Script (Optional)

Command-line debugging: python scripts/etsy_product_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 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

Dynamic pricing: credits consumed = number of products 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.