linkfox-etsy-product-query

Etsy product query (_ehunt_productQuery）

Key points

• Pagination：page starts from 1;pageSize defaults to 20, maximum 100 (≤50 recommended).
• Range parameters: same approach as the shop interface,begin* / end* in pairs.
• Sorting：sortBy is 1~6(upstream sort_by）。sortDesc：1=descending, 2=ascending(different from _ehunt_storeQuery 's 1/0).
• Product type productType：1 handmade,2 vintage,3 digital,4 custom,9 other, use commas for multiple selections.
• Currency：currencyCode defaults to USD。
• Category id：category is a single category ID; you can first get the id through the category search skill.

Script (optional)

Command-line debugging:python scripts/etsy_product_query.py '<JSON>'(requires LINKFOXAGENT_API_KEY). See references/api.md at the end.

Reference

See the input/output parameter table at references/api.md。

Resolve authentication and compute power issues

When the following abnormal situations occur, use references/onboarding.md to guide resolving the issue:

Abnormal situations

• API Key not configured: the environment variable LINKFOX_AGENT_API_KEYis not configured, and LINKFOXAGENT_API_KEY。
• Response 401 or 402 status code
• Response indicates insufficient compute power or balance: the message contains "算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值", or content with a similar meaning.

Compute power consumption rules

Billed by dynamic rules: compute power consumed = number of products returned × 1.8. Billing is based on the number of items returned on this page; turning to the next page is essentially sending another request, and it is recalculated based on the number of items returned on the next page.

Important: the service of this skill is dynamically calculated by a multiplier and may consume a large amount of compute power at once. The user must be reminded, and the user decides whether to continue.