Key Points
- Pagination:
pageStarts from 1;pageSizedefault 20, maximum 100 (recommended ≤50). - Range parameters:
*Min/*Maxappear in pairs and form an upstream range; when only one side is filled, the upstream is "start~" or "~end". - Sorting:
sortByis an integer enum (default14=weekly sales descending; also includes multiple values such as price/number of ads/competition level/sales amount; seereferences/api.md)。 - Boolean filters:
facebookAd(1=has ads),hasSupplier(1=has supply source, 0=none),showDeleted(1=include delisted) are all integer switches. - Shipping country:
countrypass a two-letter country code (e.g.,US)。
Script (optional)
Command-line debugging:python scripts/shopify_product_query.py '<JSON>'(requires LINKFOXAGENT_API_KEY). See references/api.md at the end.
Resolve authentication and compute power issues
When the following abnormal situations occur, use references/onboarding.md to guide resolution:
Abnormal situations
- API Key not configured: the environment variable is not configured with
LINKFOX_AGENT_API_KEY, andLINKFOXAGENT_API_KEY。 - Response 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.
Reference
See the input/output parameter table at references/api.md。
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; 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.