Nexscope
Start free

Amazon Marketplace Intelligence

Amazon Market Research MCP Tool

Use SellerSprite market list capability to filter Amazon niche markets by category dimensions, supporting market size, competition, top concentration, seller structure, new product share, price/rating/margin ranges, and many other criteria for discovering viable markets and evaluating product selection directions.

MCP tool name
nexscope_amazon_market_research
Legacy MCP endpoint
/api/skill-api/v1/mcp
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "amazon-market-research-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_research",
    "arguments": {
      "departmentKeyword": "phone case",
      "newProduct": 1,
      "size": 1,
      "marketplace": "US",
      "topNum": 1,
      "page": 1
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-market-research

Arguments

NameTypeRequiredMeaning
marketplacestringrequired
Site code, see [marketplace](#marketplace-options)
Example: US
nodeIdPathstringoptional
Category node ID path, e.g. 172282:281407
Example: {}
departmentKeywordstringoptional
Category keyword path, e.g. Electronics:Accessories & Supplies
Example: phone case
sellerLocationstringoptional
Seller location, multiple values comma-separated; see Seller Sprite table 1.3 for values
Example: {}
newProductintegeroptional
New product definition (months)
Example: 1
topNumintegeroptional
Top Listing count
Example: 1
monthstringoptional
Filter date: nearly or yyyyMM
Example: {}
pageintegeroptional
Page number, starting from 1
Example: 1
sizeintegeroptional
Results per page
Example: 1
orderFieldstringoptional
Sort field, see [orderField](#orderfield-options)
Example: {}
orderDescbooleanoptional
true descending, false ascending
Example: false
minAvgRevenue/maxAvgRevenuenumberoptional
Minimum / maximum average monthly sales revenue
Example: 1
minAvgUnits/maxAvgUnitsintegeroptional
Minimum / maximum average monthly sales volume
Example: 1
minGoodsCount/maxGoodsCountintegeroptional
Minimum / maximum product count
Example: 1
minSellers/maxSellersintegeroptional
Minimum / maximum seller count
Example: 1
minBrands/maxBrandsintegeroptional
Minimum / maximum brand count
Example: 1
minAvgSellers/maxAvgSellersnumberoptional
Minimum / maximum average seller count
Example: 1
minGoodsCrn/maxGoodsCrnnumberoptional
Minimum / maximum product concentration (decimal 0-1)
Example: 1
minSellerCrn/maxSellerCrnnumberoptional
Minimum / maximum seller concentration (decimal 0-1)
Example: 1
minBrandCrn/maxBrandCrnnumberoptional
Minimum / maximum brand concentration (decimal 0-1)
Example: 1
minAmazonSelfProportion/maxAmazonSelfProportionnumberoptional
Minimum / maximum Amazon self-operated share (decimal 0-1)
Example: 1
minFbaProportion/maxFbaProportionnumberoptional
Minimum / maximum FBA share (decimal 0-1)
Example: 1
minFbmProportion/maxFbmProportionnumberoptional
Minimum / maximum FBM share (decimal 0-1)
Example: 1
minEbcProportion/maxEbcProportionnumberoptional
Minimum / maximum A+ share (decimal 0-1)
Example: 1
minNewProportion/maxNewProportionnumberoptional
Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior)
Example: 1
minAvgPrice/maxAvgPricenumberoptional
Minimum / maximum average price
Example: 1
minAvgRating/maxAvgRatingnumberoptional
Minimum / maximum average rating value
Example: 1
minAvgRatings/maxAvgRatingsintegeroptional
Minimum / maximum average review count
Example: 1
minAvgProfit/maxAvgProfitnumberoptional
Minimum / maximum average gross margin (input N means N%, 0-100)
Example: 1
minAvgBsr/maxAvgBsrintegeroptional
Minimum / maximum average BSR rank
Example: 1
minNewCount/maxNewCountintegeroptional
Minimum / maximum new product count
Example: 1
minNewAvgPrice/maxNewAvgPricenumberoptional
Minimum / maximum new product average price
Example: 1
minNewAvgRating/maxNewAvgRatingnumberoptional
Minimum / maximum new product average star rating
Example: 1
minNewAvgRatings/maxNewAvgRatingsintegeroptional
Minimum / maximum new product average review count
Example: 1
minNewAvgUnits/maxNewAvgUnitsnumberoptional
Minimum / maximum new product average monthly sales
Example: 1
minNewAvgRevenue/maxNewAvgRevenuenumberoptional
Minimum / maximum new product average monthly revenue
Example: 1
minTopAvgUnits/maxTopAvgUnitsintegeroptional
Minimum / maximum top listing average monthly sales
Example: 1
minTopAvgRevenue/maxTopAvgRevenuenumberoptional
Minimum / maximum top listing average monthly revenue
Example: 1
minTopAvgBsr/maxTopAvgBsrintegeroptional
Minimum / maximum top listing average BSR
Example: 1
minWeight/maxWeightnumberoptional
Minimum / maximum weight
Example: 1
minVolume/maxVolumenumberoptional
Minimum / maximum volume
Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.totalintegeroptional
Total record count
Example: 1
data.marketplacestringoptional
Site code
Example: US
data.dataarrayoptional
Category market list (corresponds to third-party data.items)
Example: []
data.columnsarrayoptional
Render columns
Example: []
data.costTokenintegeroptional
Tokens consumed
Example: 1
data.typestringoptional
Render style
Example: null
data.data[].nodeIdstringoptional
Node ID
Example: example-id
data.data[].nodeIdPathstringoptional
Node ID path
Example: null
data.data[].nodeLabelNamestringoptional
Node name
Example: null
data.data[].nodeLabelPathstringoptional
Node name path
Example: null
data.data[].nodeLabelLocalestringoptional
Node name translation
Example: null
data.data[].nodeLabelPathLocalestringoptional
Node name path translation
Example: null
data.data[].marketplacestringoptional
Market identifier
Example: US
data.data[].currencystringoptional
Currency type for this market
Example: null
data.data[].rankingintegeroptional
Rank
Example: 1
data.data[].totalProductsintegeroptional
Total product count
Example: 1
data.data[].topProductsintegeroptional
Sample count
Example: 1
data.data[].sellersintegeroptional
Seller count
Example: 1
data.data[].brandsintegeroptional
Brand count
Example: 1
data.data[].avgSellersnumberoptional
Average seller count
Example: 1
data.data[].avgUnitsintegeroptional
Average monthly sales volume
Example: 1
data.data[].totalUnitsintegeroptional
Total monthly sales volume
Example: 1
data.data[].avgRevenuenumberoptional
Average monthly sales revenue
Example: 1
data.data[].totalRevenuenumberoptional
Total monthly sales revenue
Example: 1
data.data[].avgPricenumberoptional
Average price
Example: 1
data.data[].avgRatingnumberoptional
Average rating value
Example: 1
data.data[].avgRatingsintegeroptional
Average review count
Example: 1
data.data[].avgBsrintegeroptional
Average BSR
Example: 1
data.data[].avgProfitnumberoptional
Average profit margin (%)
Example: 1
data.data[].fbaProportionnumberoptional
FBA share (%)
Example: 1
data.data[].fbmProportionnumberoptional
FBM share (%)
Example: 1
data.data[].amazonSelfProportionnumberoptional
Amazon self-operated share (%)
Example: 1
data.data[].ebcProportionnumberoptional
A+ product share (%)
Example: 1
data.data[].returnRationumberoptional
Return rate (%)
Example: 1
data.data[].avgReturnRationumberoptional
Category average return rate (%)
Example: 1
data.data[].searchToPurchaseRationumberoptional
Search-to-purchase ratio (per mille)
Example: 1
data.data[].sellerNationstringoptional
Most common seller location code
Example: null
data.data[].sellerNationLabelstringoptional
Most common seller location label
Example: null
data.data[].sellerProportionnumberoptional
Most common seller location share (%)
Example: 1
data.data[].avgWeightnumberoptional
Average weight (pound)
Example: 1
data.data[].baseAvgWeightnumberoptional
Average weight (g)
Example: 1
data.data[].avgVolumenumberoptional
Average volume (in³)
Example: 1
data.data[].baseAvgVolumenumberoptional
Average volume (cm³)
Example: 1
data.data[].top10Imagesarrayoptional
Top 10 product images, elements see table below
Example: []
data.top10images[].imagestringoptional
Image link
Example: https://example.com/image.jpg
data.top10images[].asinstringoptional
ASIN
Example: B072MQ5BRX
data.titlestringoptional
Provider-specific response title.
Example: null
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "total": 1,
    "marketplace": "US",
    "data": [
      {
        "nodeId": "example-id",
        "marketplace": "US",
        "ranking": 1,
        "totalProducts": 1,
        "topProducts": 1,
        "sellers": 1,
        "brands": 1,
        "avgSellers": 1,
        "avgUnits": 1,
        "totalUnits": 1,
        "avgRevenue": 1,
        "totalRevenue": 1,
        "avgPrice": 1,
        "avgRating": 1,
        "avgRatings": 1,
        "avgBsr": 1,
        "avgProfit": 1,
        "fbaProportion": 1,
        "fbmProportion": 1,
        "amazonSelfProportion": 1,
        "ebcProportion": 1,
        "returnRatio": 1,
        "avgReturnRatio": 1,
        "searchToPurchaseRatio": 1,
        "sellerProportion": 1,
        "avgWeight": 1,
        "baseAvgWeight": 1,
        "avgVolume": 1,
        "baseAvgVolume": 1,
        "top10Images": []
      }
    ],
    "columns": [],
    "costToken": 1,
    "top10images": [
      {
        "image": "https://example.com/image.jpg",
        "asin": "B072MQ5BRX"
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}