Shopify Product Research

Shopify Store Query

Find Shopify stores by country, product range, sales, and audience size. Call the Shopify Store Query API via REST or MCP from 25 credits per call.

MCP tool name

nexscope_shopify_store_query

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "shopify-store-query-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_shopify_store_query",
    "arguments": {
      "page": 1,
      "pageSize": 20,
      "searchKey": "phone case"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`searchKey`	`string`	optional	Store name or domain keyword Example: {}
`country`	`string`	optional	Country code (e.g., US, CN) Example: {}
`year`	`integer`	optional	Store creation year: 1=Last 1 year, 2=1~2 years, 3=2~3 years, 4=3+ years Example: 1
`productNumMin`	`integer`	optional	Product count range start Example: 1
`productNumMax`	`integer`	optional	Product count range end Example: 1
`advertiseCountMin`	`integer`	optional	Ad count range start Example: 1
`advertiseCountMax`	`integer`	optional	Ad count range end Example: 1
`monthlyVisitMin`	`integer`	optional	Monthly visits range start Example: 1
`monthlyVisitMax`	`integer`	optional	Monthly visits range end Example: 1
`monthOrderMin`	`integer`	optional	Monthly orders range start Example: 1
`monthOrderMax`	`integer`	optional	Monthly orders range end Example: 1
`sortBy`	`integer`	optional	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) Example: 7
`orderBy`	`string`	optional	Sort direction: desc (default) / asc Example: desc
`page`	`integer`	optional	Page number (starting from 1) Example: 1
`pageSize`	`integer`	optional	Results per page, default 20, max 100 Example: 20

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of items returned on this page Example: {}
`storeNum`	`integer`	optional	Total number of eligible stores (upstream `store_num`) Example: {}
`stores`	`array`	optional	Shopify store list Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`title`	`string`	optional	Title (`Shopify store query`) Example: {}
`sourceType`	`string`	optional	Source type: shopify Example: {}
`type`	`string`	optional	Rendered style: tableListWorkbenches Example: {}
`storeId`	`store_id`	optional	Store ID Example: {}
`shopId`	`shop_id`	optional	Shopify shop ID Example: {}
`storeName`	`store_name`	optional	Store name Example: {}
`storeDomain`	`store_domain`	optional	Store domain name Example: {}
`storeLink`	`store_link`	optional	Store link Example: {}
`country`	`-`	optional	country Example: {}
`createdTime`	`created_time`	optional	creation time Example: {}
`productNum`	`product_num`	optional	Number of products Example: {}
`categoryNum`	`category_num`	optional	Number of categories Example: {}
`categories`	`-`	optional	Category list (elements include `id`, `name`) Example: {}
`monthlyVisit`	`monthly_visit`	optional	Monthly visits (formatted) Example: {}
`monthOrderNum`	`month_order_num`	optional	Monthly order volume (formatted) Example: {}
`fbFollowers`	`fb_followers`	optional	Number of Facebook fans Example: {}
`insFollowers`	`ins_followers`	optional	Instagram followers Example: {}
`advertiseCount`	`advertise_count`	optional	Number of ads Example: {}
`adLink`	`ad_link`	optional	Ad library link Example: {}
`email`	`-`	optional	Contact email Example: {}
`facebookUrl`	`facebook_url`	optional	Facebook home page Example: {}
`instagramUrl`	`instagram_url`	optional	Instagram Home Page Example: {}
`socialLinks`	`social_links`	optional	Social Media Links (Map) Example: {}
`globalRank`	`global_rank`	optional	global ranking Example: {}
`logo`	`-`	optional	Store Logo URL Example: {}
`availableStatus`	`available_status`	optional	Is it active: 1=active Example: {}

Examples

Example arguments

{
  "page": 1,
  "pageSize": 20,
  "searchKey": "phone case"
}

Example structuredContent

{}