linkfox-etsy-store-query

Etsy Shop Query

Key Points

• Pagination：page Starts from 1;pageSize default 20, maximum 100.
• Range parameters：begin* / end* correspond in pairs to the upstream comma range; when only one side is filled, the upstream is "start~" or "~end".
• Sorting：sortBy Only 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 API's sortDesc ).

Script (optional)

Command-line debugging:python scripts/etsy_store_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 problem resolution:

Abnormal situations

• API Key not configured: the environment variable is not configured with LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
• Response with 401 or 402 status code
• Response indicates insufficient compute power or balance: the message contains "insufficient compute power balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Compute power consumption rules

Billed according to dynamic rules: compute power consumed = number of shops returned × 1.8. Billed by the number of items returned on this page; going 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.