Amazon Intelligence SS

Amazon Intelligence SS: product Search API

Amazon Intelligence SS: product Search API.

MCP tool name

nexscope_data_ss_product_search

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-ss-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_ss_product_search",
    "arguments": {
      "keyword": "yoga mat",
      "marketplace": "US",
      "maxPrice": 50,
      "minPrice": 10,
      "minUnits": 300,
      "order": {
        "desc": "true",
        "field": "total_units"
      },
      "page": 1,
      "size": 20
    }
  }
}

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
`chatId`	`string`	optional	Conversation id, maxLength 1000 Example: {}
`uid`	`string`	optional	User id, maxLength 1000 Example: {}
`requestId`	`string`	optional	Push id, maxLength 1000 Example: {}
`teamId`	`string`	optional	Team id, maxLength 1000 Example: {}
`keyword`	`string`	optional	Search keywords, it is recommended to use the target site language; maxLength 10240 Example: {}
`matchType`	`integer`	optional	Matching method: `1` phrase matching, `2` fuzzy matching, `3` precise matching Example: 1
`excludeKeywords`	`string`	optional	Exclude keywords; maxLength 10240 Example: {}
`marketplace`	`string`	optional	Only `US`, `UK`, `DE`, `FR`, `JP`, `CA`, `IT`, `ES`, `MX`, `IN` allowed Example: US
`nodeLabel`	`string`	optional	Amazon category name; maxLength 1000 Example: {}
`nodeIdPath`	`string`	optional	Amazon category node ID; maxLength 1000 Example: {}
`filterSubNode`	`boolean`	optional	Whether to filter subcategory nodes; only takes effect when nodeLabel or nodeIdPath has a value Example: {}
`dataSnapshotMonth`	`string`	optional	Product data snapshot year and month in `yyyyMM` format, or `nearly` representing the last 30 days of real-time data; maxLength 1000 Example: nearly
`minPrice`	`number`	optional	lowest price (>= 0) Example: {}
`maxPrice`	`number`	optional	Highest price (>= 0) Example: {}
`minProfit`	`number`	optional	Minimum gross profit margin, unit % (1–100) Example: {}
`maxProfit`	`number`	optional	Maximum gross profit margin, unit % (1–100) Example: {}
`minRevenue`	`number`	optional	Minimum monthly sales (>= 0) Example: {}
`maxRevenue`	`number`	optional	Highest monthly sales (>= 0) Example: {}
`minFba`	`number`	optional	Minimum FBA shipping (>= 0) Example: {}
`maxFba`	`number`	optional	Maximum FBA shipping fee (>= 0) Example: {}
`minUnits`	`integer`	optional	Minimum monthly sales volume (>= 0) Example: {}
`maxUnits`	`integer`	optional	Highest monthly sales (>= 0) Example: {}
`minAmzUnit`	`integer`	optional	Minimum sub-body sales volume in the past 30 days; only `dataSnapshotMonth` is supported for queries in the past 30 days, the minimum value is 0 Example: {}
`maxAmzUnit`	`integer`	optional	The highest sub-body sales volume in the past 30 days; only the query in the past 30 days is supported, the minimum value is 0 Example: {}
`minUnitsGrowthRate`	`number`	optional	Minimum monthly sales growth rate, unit % Example: {}
`maxUnitsGrowthRate`	`number`	optional	Maximum monthly sales growth rate, unit % Example: {}
`minBsr`	`integer`	optional	Category BSR lowest ranking Example: {}
`maxBsr`	`integer`	optional	Top Category BSR Ranking Example: {}
`minBsrGrowthRate`	`number`	optional	BSR minimum growth rate, unit % Example: {}
`maxBsrGrowthRate`	`number`	optional	BSR maximum growth rate, unit % Example: {}
`minBsrGrowthCount`	`integer`	optional	BSR minimum growth number Example: {}
`maxBsrGrowthCount`	`integer`	optional	BSR highest growth number Example: {}
`minSubNodeBsrRank`	`integer`	optional	Subcategory BSR lowest ranking; requires `filterSubNode=true` Example: {}
`maxSubNodeBsrRank`	`integer`	optional	Subcategory BSR maximum ranking; requires `filterSubNode=true` Example: {}
`minRating`	`number`	optional	Lowest rating value (0–5) Example: {}
`maxRating`	`number`	optional	Highest rating value (0–5) Example: {}
`minRatings`	`integer`	optional	Minimum number of ratings (0–10000) Example: {}
`maxRatings`	`integer`	optional	Maximum number of ratings (0–10000) Example: {}
`minRatingsGrowthCount`	`integer`	optional	Minimum number of new ratings per month (>= 0) Example: {}
`maxRatingsGrowthCount`	`integer`	optional	Highest number of new ratings per month (>= 0) Example: {}
`minListingQualityScore`	`number`	optional	Minimum Listing page quality score (>= 0) Example: {}
`maxListingQualityScore`	`number`	optional	Highest Listing page quality score (>= 0) Example: {}
`minVariations`	`integer`	optional	Minimum number of variants Example: {}
`maxVariations`	`integer`	optional	Highest number of variants Example: {}
`minWeights`	`number`	optional	Minimum weight (>= 0) Example: {}
`maxWeights`	`number`	optional	Maximum weight (>= 0) Example: {}
`weightUnit`	`string`	optional	Weight unit: `g`, `kg`, `oz`, `lb`; must be specified when using weight filtering Example: {}
`dimensionType`	`string`	optional	Packaging size type, please see the description below for each site code Example: {}
`minSellers`	`integer`	optional	Minimum number of sellers Example: {}
`maxSellers`	`integer`	optional	Maximum number of sellers Example: {}
`badgeBestSeller`	`string`	optional	Best Seller Logo: `Y`, `N` or leave blank Example: {}
`badgeAmazonsChoice`	`string`	optional	Amazon's Choice logo: `Y`, `N` or leave blank Example: {}
`badgeNewRelease`	`string`	optional	New Release ID: `Y`, `N` or leave blank Example: {}
`fulfillment`	`string`	optional	Delivery method: `AMZ`, `FBA`, `FBM`, multiple values separated by English commas Example: {}
`showVariation`	`string`	optional	Whether to query variants: `Y` or `N` Example: N
`hideUnlistedProduct`	`boolean`	optional	Whether to hide removed products Example: true
`listedWithinLastMonths`	`integer`	optional	Shelf time range (months), only `1`, `3`, `6`, `12`, `24` allowed Example: {}
`sellerNation`	`string`	optional	Seller's location code, multiple values separated by commas Example: {}
`includeSellers`	`string`	optional	Includes seller; maxLength 10240 Example: {}
`excludeSellers`	`string`	optional	Exclude sellers; maxLength 10240 Example: {}
`includeBrands`	`string`	optional	Contains brand; maxLength 10240 Example: {}
`excludeBrands`	`string`	optional	Exclude brands; maxLength 10240 Example: {}
`order`	`object`	optional	Sorting configuration; it is recommended to provide both `field` and `desc` when passing in Example: {}
`order.field`	`string`	optional	Sorting fields: `total_units`, `total_amount`, `bsr_rank`, `price`, `rating`, `reviews`, `profit`, `reviews_rate`, `available_date`, `questions`, `total_units_growth`, `total_amount_growth`, `reviews_increasement`, `bsr_rank_cv`, `bsr_rank_cr`, `amz_unit`; passing an empty string means not to sort by the above business fields Example: total_units
`order.desc`	`string`	optional	`"true"` descending order, `"false"` ascending order Example: true
`page`	`integer`	optional	Page number, starting from 1 Example: 1
`size`	`integer`	optional	Number of items per page, 10–100 Example: 20

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of matching products Example: {}
`products`	`array`	optional	Product list Example: {}
`columns`	`array`	optional	Rendered column definitions Example: {}
`keyword`	`string`	optional	Search keywords used (if any) Example: {}
`nodeIdPath`	`string`	optional	Search category node Example: {}
`nodeLabel`	`string`	optional	Amazon category name Example: {}
`dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`sourceType`	`string`	optional	Source type, such as `amazon` Example: {}
`type`	`string`	optional	rendering style Example: {}
`message`	`string`	optional	Additional message or error message Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`asin`	`string`	optional	Amazon ASIN Example: {}
`title`	`string`	optional	Product title Example: {}
`asinUrl`	`string`	optional	Amazon product detail page URL Example: {}
`imageUrl`	`string`	optional	Product image URL Example: {}
`price`	`number`	optional	current price Example: {}
`averagePrice`	`number`	optional	average price Example: {}
`primePrice`	`number`	optional	Prime price, -1 means none Example: {}
`currency`	`string`	optional	Currency Example: {}
`monthlySalesUnits`	`integer`	optional	monthly sales Example: {}
`monthlySalesRevenue`	`number`	optional	monthly sales Example: {}
`monthlySalesUnitsGrowthRate`	`number`	optional	monthly sales growth rate Example: {}
`bsr`	`integer`	optional	BSR Ranking Example: {}
`bsrGrowthRate`	`number`	optional	BSR growth rate Example: {}
`rating`	`number`	optional	Rating Example: {}
`ratings`	`integer`	optional	Rating number Example: {}
`ratingsRate`	`number`	optional	Review rate Example: {}
`profit`	`number`	optional	Gross profit margin (%) Example: {}
`fba`	`number`	optional	FBA shipping Example: {}
`sellerNum`	`integer`	optional	Number of sellers Example: {}
`sellerId`	`string`	optional	BuyBox seller ID Example: {}
`sellerName`	`string`	optional	BuyBox seller name Example: {}
`sellerNation`	`string`	optional	BuyBox seller nationality Example: {}
`brand`	`string`	optional	brand Example: {}
`brandUrl`	`string`	optional	Brand page URL Example: {}
`fulfillment`	`string`	optional	Shipping method (AMZ/FBA/FBM) Example: {}
`availableDate`	`string`	optional	Release time (timestamp) Example: {}
`availableDateString`	`string`	optional	Release date (formatted string) Example: {}
`variationNum`	`integer`	optional	number of variants Example: {}
`variant30DayUnits`	`integer`	optional	Monthly sales volume of daughter bodies (number of pieces) Example: {}
`variant30DayRevenue`	`number`	optional	Subsidiary monthly sales Example: {}
`variant30DayUpdatedAt`	`string`	optional	Subbody data update time Example: {}
`weight`	`string`	optional	weight Example: {}
`packageWeight`	`string`	optional	Packing weight Example: {}
`dimension`	`string`	optional	Size Example: {}
`packageDimensions`	`string`	optional	Packing size Example: {}
`dimensionsType`	`string`	optional	size type Example: {}
`packageDimensionType`	`string`	optional	Packaging size type Example: {}
`listingQualityScore`	`number`	optional	Listing quality score Example: {}
`deliveryPrice`	`number`	optional	Seller shipping fee, -1 means none Example: {}
`nodeLabelPath`	`string`	optional	Category path Example: {}
`nodeIdPath`	`string`	optional	Node ID path Example: {}
`nodeId`	`integer`	optional	Node ID Example: {}
`dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`badgeBestSeller`	`string`	optional	Best Seller logo (Y/N) Example: {}
`badgeAmazonChoice`	`string`	optional	Amazon's Choice logo (Y/N) Example: {}
`badgeNewRelease`	`string`	optional	New Release logo (Y/N) Example: {}
`badgeVideo`	`string`	optional	Video introduction logo (Y/N) Example: {}
`badgeEbc`	`string`	optional	A+ page identification (Y/N) Example: {}
`badge`	`object`	optional	Identity summary object, including `bestSeller`, `amazonChoice`, `newRelease`, `video`, `ebc` Example: {}
`subcategories`	`array`	optional	List of subcategories, each containing `code`, `rank`, `label` Example: {}
`sku`	`string`	optional	SKU Example: {}
`keyword`	`string`	optional	Keywords corresponding to filtering Example: {}
`sourceType`	`string`	optional	Source type Example: {}

Examples

Example arguments

{
  "keyword": "yoga mat",
  "marketplace": "US",
  "maxPrice": 50,
  "minPrice": 10,
  "minUnits": 300,
  "order": {
    "desc": "true",
    "field": "total_units"
  },
  "page": 1,
  "size": 20
}

Example structuredContent

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