Key Points
- Pagination:
pageStarts from 1;pageSizedefault 20, maximum 100. - Range parameters:
*Min/*Maxappear in pairs (product count, ad count, monthly visits, monthly orders), forming the upstream range. - Store age
year: 1=last 1 year, 2=12 years, 3=23 years, 4=3 years or more. - Sorting:
sortByinteger enum (0=product count,1=category count,2=monthly visits,3=FB followers,4=Ins followers,5=ad count,6=relevance,7=monthly orders default);orderByisdesc(default)/asc。 - Country:
countrypass the country code (e.g.,US、CN)。
Script (optional)
Command-line debugging:python scripts/shopify_store_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 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 stores 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. Users must be reminded, and the user decides whether to continue.