Amazon Intelligence SS

Amazon Market Research

Assess niche size, competition, and seller concentration. Call the Amazon Market Research API via REST or MCP from 21 credits per call.

MCP tool name

nexscope_amazon_market_research

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": "amazon-market-research-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_research",
    "arguments": {
      "departmentKeyword": "phone case",
      "marketplace": "US",
      "newProduct": 3,
      "page": 1,
      "size": 50,
      "topNum": 10
    }
  }
}

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
`marketplace`	`string`	required	Site code, see [marketplace](#marketplace-options) Example: US
`nodeIdPath`	`string`	optional	Category node ID path, e.g. 172282:281407 Example: {}
`departmentKeyword`	`string`	optional	Category keyword path, e.g. Electronics:Accessories & Supplies Example: phone case
`sellerLocation`	`string`	optional	Seller location, multiple values comma-separated; see Nexscope table 1.3 for values Example: {}
`newProduct`	`integer`	optional	New product definition (months) Example: 3
`topNum`	`integer`	optional	Top Listing count Example: 10
`month`	`string`	optional	Filter date: nearly or yyyyMM Example: {}
`page`	`integer`	optional	Page number, starting from 1 Example: 1
`size`	`integer`	optional	Results per page Example: 50
`orderField`	`string`	optional	Sort field, see [orderField](#orderfield-options) Example: {}
`orderDesc`	`boolean`	optional	true descending, false ascending Example: false
`minAvgRevenue`	`number`	optional	Minimum / maximum average monthly sales revenue Example: 1
`maxAvgRevenue`	`number`	optional	Minimum / maximum average monthly sales revenue Example: 1
`minAvgUnits`	`integer`	optional	Minimum / maximum average monthly sales volume Example: 1
`maxAvgUnits`	`integer`	optional	Minimum / maximum average monthly sales volume Example: 1
`minGoodsCount`	`integer`	optional	Minimum / maximum product count Example: 1
`maxGoodsCount`	`integer`	optional	Minimum / maximum product count Example: 1
`minSellers`	`integer`	optional	Minimum / maximum seller count Example: 1
`maxSellers`	`integer`	optional	Minimum / maximum seller count Example: 1
`minBrands`	`integer`	optional	Minimum / maximum brand count Example: 1
`maxBrands`	`integer`	optional	Minimum / maximum brand count Example: 1
`minAvgSellers`	`number`	optional	Minimum / maximum average seller count Example: 1
`maxAvgSellers`	`number`	optional	Minimum / maximum average seller count Example: 1
`minGoodsCrn`	`number`	optional	Minimum / maximum product concentration (decimal 0-1) Example: 1
`maxGoodsCrn`	`number`	optional	Minimum / maximum product concentration (decimal 0-1) Example: 1
`minSellerCrn`	`number`	optional	Minimum / maximum seller concentration (decimal 0-1) Example: 1
`maxSellerCrn`	`number`	optional	Minimum / maximum seller concentration (decimal 0-1) Example: 1
`minBrandCrn`	`number`	optional	Minimum / maximum brand concentration (decimal 0-1) Example: 1
`maxBrandCrn`	`number`	optional	Minimum / maximum brand concentration (decimal 0-1) Example: 1
`minAmazonSelfProportion`	`number`	optional	Minimum / maximum Amazon self-operated share (decimal 0-1) Example: 1
`maxAmazonSelfProportion`	`number`	optional	Minimum / maximum Amazon self-operated share (decimal 0-1) Example: 1
`minFbaProportion`	`number`	optional	Minimum / maximum FBA share (decimal 0-1) Example: 1
`maxFbaProportion`	`number`	optional	Minimum / maximum FBA share (decimal 0-1) Example: 1
`minFbmProportion`	`number`	optional	Minimum / maximum FBM share (decimal 0-1) Example: 1
`maxFbmProportion`	`number`	optional	Minimum / maximum FBM share (decimal 0-1) Example: 1
`minEbcProportion`	`number`	optional	Minimum / maximum A+ share (decimal 0-1) Example: 1
`maxEbcProportion`	`number`	optional	Minimum / maximum A+ share (decimal 0-1) Example: 1
`minNewProportion`	`number`	optional	Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior) Example: 1
`maxNewProportion`	`number`	optional	Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior) Example: 1
`minAvgPrice`	`number`	optional	Minimum / maximum average price Example: 1
`maxAvgPrice`	`number`	optional	Minimum / maximum average price Example: 1
`minAvgRating`	`number`	optional	Minimum / maximum average rating value Example: 1
`maxAvgRating`	`number`	optional	Minimum / maximum average rating value Example: 1
`minAvgRatings`	`integer`	optional	Minimum / maximum average review count Example: 1
`maxAvgRatings`	`integer`	optional	Minimum / maximum average review count Example: 1
`minAvgProfit`	`number`	optional	Minimum / maximum average gross margin (input N means N%, 0-100) Example: 1
`maxAvgProfit`	`number`	optional	Minimum / maximum average gross margin (input N means N%, 0-100) Example: 1
`minAvgBsr`	`integer`	optional	Minimum / maximum average BSR rank Example: 1
`maxAvgBsr`	`integer`	optional	Minimum / maximum average BSR rank Example: 1
`minNewCount`	`integer`	optional	Minimum / maximum new product count Example: 1
`maxNewCount`	`integer`	optional	Minimum / maximum new product count Example: 1
`minNewAvgPrice`	`number`	optional	Minimum / maximum new product average price Example: 1
`maxNewAvgPrice`	`number`	optional	Minimum / maximum new product average price Example: 1
`minNewAvgRating`	`number`	optional	Minimum / maximum new product average star rating Example: 1
`maxNewAvgRating`	`number`	optional	Minimum / maximum new product average star rating Example: 1
`minNewAvgRatings`	`integer`	optional	Minimum / maximum new product average review count Example: 1
`maxNewAvgRatings`	`integer`	optional	Minimum / maximum new product average review count Example: 1
`minNewAvgUnits`	`number`	optional	Minimum / maximum new product average monthly sales Example: 1
`maxNewAvgUnits`	`number`	optional	Minimum / maximum new product average monthly sales Example: 1
`minNewAvgRevenue`	`number`	optional	Minimum / maximum new product average monthly revenue Example: 1
`maxNewAvgRevenue`	`number`	optional	Minimum / maximum new product average monthly revenue Example: 1
`minTopAvgUnits`	`integer`	optional	Minimum / maximum top listing average monthly sales Example: 1
`maxTopAvgUnits`	`integer`	optional	Minimum / maximum top listing average monthly sales Example: 1
`minTopAvgRevenue`	`number`	optional	Minimum / maximum top listing average monthly revenue Example: 1
`maxTopAvgRevenue`	`number`	optional	Minimum / maximum top listing average monthly revenue Example: 1
`minTopAvgBsr`	`integer`	optional	Minimum / maximum top listing average BSR Example: 1
`maxTopAvgBsr`	`integer`	optional	Minimum / maximum top listing average BSR Example: 1
`minWeight`	`number`	optional	Minimum / maximum weight Example: 1
`maxWeight`	`number`	optional	Minimum / maximum weight Example: 1
`minVolume`	`number`	optional	Minimum / maximum volume Example: 1
`maxVolume`	`number`	optional	Minimum / maximum volume Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of items Example: {}
`marketplace`	`string`	optional	Site encoding Example: {}
`data`	`array`	optional	Category market list (corresponding to third-party `data.items`) Example: {}
`columns`	`array`	optional	Rendered columns Example: {}
`costToken`	`integer`	optional	Consume token Example: {}
`type`	`string`	optional	rendering style Example: {}
`nodeId`	`string`	optional	Node ID Example: {}
`nodeIdPath`	`string`	optional	Node ID path Example: {}
`nodeLabelName`	`string`	optional	Node name Example: {}
`nodeLabelPath`	`string`	optional	Node name path Example: {}
`nodeLabelLocale`	`string`	optional	Node name translation Example: {}
`nodeLabelPathLocale`	`string`	optional	Node name path translation Example: {}
`marketplace`	`string`	optional	market sign Example: {}
`currency`	`string`	optional	The currency type of this market Example: {}
`ranking`	`integer`	optional	Ranking Example: {}
`totalProducts`	`integer`	optional	Total number of items Example: {}
`topProducts`	`integer`	optional	sample size Example: {}
`sellers`	`integer`	optional	Number of sellers Example: {}
`brands`	`integer`	optional	Number of brands Example: {}
`avgSellers`	`number`	optional	Average number of sellers Example: {}
`avgUnits`	`integer`	optional	average monthly sales Example: {}
`totalUnits`	`integer`	optional	Total monthly sales Example: {}
`avgRevenue`	`number`	optional	average monthly sales Example: {}
`totalRevenue`	`number`	optional	total monthly sales Example: {}
`avgPrice`	`number`	optional	average price Example: {}
`avgRating`	`number`	optional	average rating Example: {}
`avgRatings`	`integer`	optional	average rating Example: {}
`avgBsr`	`integer`	optional	Average BSR Example: {}
`avgProfit`	`number`	optional	Average profit margin (%) Example: {}
`fbaProportion`	`number`	optional	FBA proportion (%) Example: {}
`fbmProportion`	`number`	optional	FBM proportion (%) Example: {}
`amazonSelfProportion`	`number`	optional	Amazon’s self-operated share (%) Example: {}
`ebcProportion`	`number`	optional	A+ product proportion (%) Example: {}
`returnRatio`	`number`	optional	Return rate (%) Example: {}
`avgReturnRatio`	`number`	optional	Return rate category average (%) Example: {}
`searchToPurchaseRatio`	`number`	optional	Search to purchase ratio (per thousand) Example: {}
`sellerNation`	`string`	optional	Most sellers’ code Example: {}
`sellerNationLabel`	`string`	optional	Label with the most sellers’ locations Example: {}
`sellerProportion`	`number`	optional	Proportion of where the most sellers belong (%) Example: {}
`avgWeight`	`number`	optional	Average weight (pound) Example: {}
`baseAvgWeight`	`number`	optional	Average weight (g) Example: {}
`avgVolume`	`number`	optional	Average volume (in³) Example: {}
`baseAvgVolume`	`number`	optional	Average volume (cm³) Example: {}
`top10Images`	`array`	optional	The top 10 product pictures, the elements are shown in the table below Example: {}
`image`	`string`	optional	Image link Example: {}
`asin`	`string`	optional	ASIN Example: {}

Examples

Example arguments

{
  "departmentKeyword": "phone case",
  "marketplace": "US",
  "newProduct": 3,
  "page": 1,
  "size": 50,
  "topNum": 10
}

Example structuredContent

{}