Shopify Commerce

Shopify Store Query

Filter Shopify standalone stores by multiple dimensions (store name/domain, country, years since creation, product count, ad count, monthly visits, monthly orders, social media followers, etc.). Triggered when users mention Shopify stores, Shopify store analysis, standalone stores, Shopify sellers, competitor standalone stores, Shopify monthly visits, standalone store ad library, shopify stores, or Shopify store query. Even if the user does not mention the tool name, this skill should be triggered whenever searching for stores, filtering store data, or analyzing store performance on Shopify standalone stores.

post/api/skill-api/v1/skills/shopify-store-query/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/shopify-store-query/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

searchKeystring

Store name or domain keyword

countrystring

Country code (e.g., US, CN)

yearinteger

Store creation year: 1=Last 1 year, 2=12 years, 3=23 years, 4=3+ years

productNumMininteger

Product count range start

productNumMaxinteger

Product count range end

advertiseCountMininteger

Ad count range start

advertiseCountMaxinteger

Ad count range end

monthlyVisitMininteger

Monthly visits range start

monthlyVisitMaxinteger

Monthly visits range end

monthOrderMininteger

Monthly orders range start

monthOrderMaxinteger

Monthly orders range end

sortByinteger

Sort field: 0=Product count, 1=Category count, 2=Monthly visits, 3=FB followers, 4=Ins followers, 5=Ad count, 6=Relevance, 7=Monthly orders (default)

orderBystring

Sort direction: desc (default) / asc

pageinteger

Page number (starting from 1)

pageSizeinteger

Results per page, max 100

keywordstring

Example request

{
  "page": 1,
  "keyword": "phone case",
  "pageSize": 10
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "total": 1,
    "storeNum": 1,
    "stores": []
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.