Shopee Product Research

Shopee Product Research: shopee/get Product Infos API

Shopee Product Research: shopee/get Product Infos API.

MCP tool name

nexscope_data_yy_shopee_get_product_infos

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": "data-yy-shopee-get-product-infos-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_yy_shopee_get_product_infos",
    "arguments": {
      "keyword": "Storage Box",
      "keywordType": 2,
      "orderBy": "sold",
      "orderByType": "DESC",
      "pageSize": 50,
      "soldMin": 100,
      "station": "malaysia"
    }
  }
}

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
`station`	`string`	optional	Required. Shopee site, you can pass the name or code. See site mapping table below. Example: {}
`keyword`	`string`	optional	Product title keywords. Example: {}
`keywordType`	`integer`	optional	Matching mode: 1=whole sentence (default), 2=multi-word AND, 3=multi-word OR. Example: {}
`notExistKeyword`	`string`	optional	Exclude products containing this keyword. Example: {}
`notExistKeywordType`	`integer`	optional	Exclude match patterns: 1=whole sentence (default), 2=multi-word AND, 3=multi-word OR. Example: {}
`priceMin`	`number`	optional	Total product price starting value (local currency). Example: {}
`priceMax`	`number`	optional	The end value of the total price of the product. Example: {}
`soldMin`	`integer`	optional	The starting value of the number of units sold in the previous 30 days. Example: {}
`soldMax`	`integer`	optional	The end value of the number of units sold in the previous 30 days. Example: {}
`estimateSoldStart`	`integer`	optional	Estimate the starting value of the number of units sold in the first 30 days. Example: {}
`estimateSoldEnd`	`integer`	optional	Estimate the end value of the number of units sold in the first 30 days. Example: {}
`historicalSoldStart`	`integer`	optional	The starting value of the total number of units sold of the product. Example: {}
`historicalSoldEnd`	`integer`	optional	The end value of the total number of units sold of the product. Example: {}
`paymentStart`	`number`	optional	The starting value of sales amount in the previous 30 days. Example: {}
`paymentEnd`	`number`	optional	Ending value of sales amount in the previous 30 days. Example: {}
`ratingMin`	`number`	optional	Minimum product rating (0-5). Example: {}
`ratingMax`	`number`	optional	Maximum product rating. Example: {}
`ratingsMin`	`integer`	optional	The starting value of the score. Example: {}
`ratingsMax`	`integer`	optional	The end value of the score. Example: {}
`favoriteMin`	`integer`	optional	The starting value of the number of collections. Example: {}
`favoriteMax`	`integer`	optional	End value of collection count. Example: {}
`skuNumberStart`	`integer`	optional	Starting value of the total number of SKUs. Example: {}
`skuNumberEnd`	`integer`	optional	The end value of the total number of SKUs. Example: {}
`listingDateFrom`	`string`	optional	The starting value of product shelf time (format: yyyy-MM-dd). Example: {}
`listingDateTo`	`string`	optional	Product shelf end value (format: yyyy-MM-dd). Example: {}
`statTimeStart`	`string`	optional	Starting value of statistical time (format: yyyy-MM-dd HH:mm:ss). Example: {}
`statTimeEnd`	`string`	optional	End value of statistical time (format: yyyy-MM-dd HH:mm:ss). Example: {}
`lastModiTimeStart`	`string`	optional	The latest crawl time starting value (format: yyyy-MM-dd). Example: {}
`lastModiTimeEnd`	`string`	optional	The latest crawl time end value (format: yyyy-MM-dd). Example: {}
`approvedDateStart`	`string`	optional	The starting value of the store opening time (format: yyyy-MM-dd). Example: {}
`approvedDateEnd`	`string`	optional	The end value of the store opening time (format: yyyy-MM-dd). Example: {}
`pL1Id`	`string`	optional	Level 1 category ID. Example: {}
`pL2Id`	`string`	optional	Level 2 category ID. Example: {}
`pL3Id`	`string`	optional	Level 3 category ID. Example: {}
`cidList`	`string`	optional	Category id list, complete path, multiple groups separated by `｜`, such as: `AAA,BBB,CCC｜DDD,EEE`. Example: {}
`shopIdList`	`string`	optional	Specify a list of store IDs, separated by multiple commas. Example: {}
`notExistShopIdList`	`string`	optional	Exclude a list of store IDs, separated by multiple commas. Example: {}
`merchant`	`string`	optional	Store name or user name. Example: {}
`shopLocation`	`string`	optional	Store location. Example: {}
`shippingIconType`	`integer`	optional	Store location: 0=local, 1=overseas. Example: {}
`cbOption`	`integer`	optional	Shipping location: 0=domestic, 1=cross-border. Example: {}
`isShopeeVerified`	`integer`	optional	Shopee Preferred: 0=not preferred, 1=preferred. Example: {}
`isOfficialShop`	`integer`	optional	Official store: 0=no, 1=yes. Example: {}
`isHotSales`	`integer`	optional	Whether it is a hot seller: 0 = not a hot seller, 1 = a hot seller. Example: {}
`pids`	`string`	optional	List of product IDs (up to 500), separated by commas. Example: {}
`orderBy`	`string`	optional	Sorting fields: `rating` (rating), `price` (price), `historical_sold` (total sales), `sold` (30-day sales), `payment` (30-day sales), `favorite` (number of collections), `ratings` (number of ratings), `gen_time` (time on shelves), `estimate_sold` (estimated sales). Example: {}
`orderByType`	`string`	optional	Sorting direction: `ASC` (ascending order), `DESC` (descending order). Example: DESC
`page`	`integer`	optional	Page number (starting from 1). Example: 1
`pageSize`	`integer`	optional	Number of items per page (range 1-1000). Example: 1000

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	The current number of records returned. Example: {}
`totalSize`	`integer`	optional	Total number of results. Example: {}
`sourceType`	`string`	optional	Source type: `shopee`. Example: {}
`columns`	`array`	optional	Render column definitions. Example: {}
`costToken`	`integer`	optional	Consume token. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`products`	`array`	optional	List of products (see fields below). Example: {}
`pid`	`string`	optional	Product unique ID. Example: {}
`title`	`string`	optional	Product title. Example: {}
`description`	`string`	optional	Product description. Example: {}
`imageUrl`	`string`	optional	Product main image URL. Example: {}
`productUrl`	`string`	optional	Shopee product link. Example: {}
`shopeeUrl`	`string`	optional	Product links under the Shopee domain name. Example: {}
`price`	`number`	optional	Product default price (local currency). Example: {}
`minPrice`	`number`	optional	SKU lowest price. Example: {}
`maxPrice`	`number`	optional	The highest price of the SKU. Example: {}
`sold`	`integer`	optional	Number of units sold in the previous 30 days. Example: {}
`estimateSold`	`integer`	optional	Estimate the number of units sold in the previous 30 days. Example: {}
`historicalSold`	`integer`	optional	The total number of items sold. Example: {}
`payment`	`number`	optional	Sales in the previous 30 days (local currency). Example: {}
`rating`	`number`	optional	Product rating (0-5). Example: {}
`ratings`	`integer`	optional	Rating number. Example: {}
`favorite`	`integer`	optional	Number of collections. Example: {}
`viewCount`	`integer`	optional	Number of views. Example: {}
`stock`	`integer`	optional	Stock count. Example: {}
`skuNumber`	`integer`	optional	SKU quantity. Example: {}
`genTime`	`string`	optional	Shelf time. Example: {}
`statTime`	`string`	optional	Statistics time. Example: {}
`lastModiTime`	`string`	optional	Latest crawl time. Example: {}
`categoryStructure`	`string`	optional	Category structure path. Example: {}
`cid`	`string`	optional	Category IDs (comma separated). Example: {}
`shopId`	`string`	optional	Store ID. Example: {}
`shopName`	`string`	optional	Store name. Example: {}
`shopUrl`	`string`	optional	Store link. Example: {}
`userName`	`string`	optional	Store owner name. Example: {}
`shopLocation`	`string`	optional	Store location. Example: {}
`shopProductsCount`	`integer`	optional	The total number of items in the store. Example: {}
`approvedDate`	`string`	optional	Store opening hours. Example: {}
`isOfficialShop`	`integer`	optional	Is it an official store (1=yes, 0=no). Example: {}
`isShopeeVerified`	`integer`	optional	Shopee is preferred (1=yes, 0=no). Example: {}
`isHotSales`	`integer`	optional	Is it a hot seller (1=yes, 0=no). Example: {}
`shippingIconType`	`integer`	optional	Store location type (0=local, 1=overseas, 3 or null=unknown). Example: {}
`cbOption`	`integer`	optional	Shipping location (0=domestic, 1=cross-border). Example: {}
`estimatedDays`	`integer`	optional	Estimated days of arrival. Example: {}
`status`	`integer`	optional	Product status (1=normal, 0=removed, 8=excluded from list). Example: {}
`notExist`	`integer`	optional	Whether it exists (0=exists, 1=does not exist). Example: {}

Examples

Example arguments

{
  "keyword": "Storage Box",
  "keywordType": 2,
  "orderBy": "sold",
  "orderByType": "DESC",
  "pageSize": 50,
  "soldMin": 100,
  "station": "malaysia"
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}