Amazon
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.
nexscope_amazon_market_researchhttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then 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": {
"size": 50,
"newProduct": 3,
"departmentKeyword": "phone case",
"page": 1,
"topNum": 10,
"marketplace": "US"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/amazon-market-researchProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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 Seller Sprite 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 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Total record count Example: 1 |
data.marketplace | string | optional | Site code Example: US |
data.data | array | optional | Category market list (corresponds to third-party data.items) Example: [] |
data.data[] | object | required |
{
"size": 50,
"newProduct": 3,
"departmentKeyword": "phone case",
"page": 1,
"topNum": 10,
"marketplace": "US"
}{
"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": [
{
"image": "https://example.com/image.jpg",
"asin": "B072MQ5BRX"
}
]
}
],
"columns": [],
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Item in data data. |
data.data[].nodeId | string | optional | Node ID Example: example-id |
data.data[].nodeIdPath | string | optional | Node ID path Example: null |
data.data[].nodeLabelName | string | optional | Node name Example: null |
data.data[].nodeLabelPath | string | optional | Node name path Example: null |
data.data[].nodeLabelLocale | string | optional | Node name translation Example: null |
data.data[].nodeLabelPathLocale | string | optional | Node name path translation Example: null |
data.data[].marketplace | string | optional | Market identifier Example: US |
data.data[].currency | string | optional | Currency type for this market Example: null |
data.data[].ranking | integer | optional | Rank Example: 1 |
data.data[].totalProducts | integer | optional | Total product count Example: 1 |
data.data[].topProducts | integer | optional | Sample count Example: 1 |
data.data[].sellers | integer | optional | Seller count Example: 1 |
data.data[].brands | integer | optional | Brand count Example: 1 |
data.data[].avgSellers | number | optional | Average seller count Example: 1 |
data.data[].avgUnits | integer | optional | Average monthly sales volume Example: 1 |
data.data[].totalUnits | integer | optional | Total monthly sales volume Example: 1 |
data.data[].avgRevenue | number | optional | Average monthly sales revenue Example: 1 |
data.data[].totalRevenue | number | optional | Total monthly sales revenue Example: 1 |
data.data[].avgPrice | number | optional | Average price Example: 1 |
data.data[].avgRating | number | optional | Average rating value Example: 1 |
data.data[].avgRatings | integer | optional | Average review count Example: 1 |
data.data[].avgBsr | integer | optional | Average BSR Example: 1 |
data.data[].avgProfit | number | optional | Average profit margin (%) Example: 1 |
data.data[].fbaProportion | number | optional | FBA share (%) Example: 1 |
data.data[].fbmProportion | number | optional | FBM share (%) Example: 1 |
data.data[].amazonSelfProportion | number | optional | Amazon self-operated share (%) Example: 1 |
data.data[].ebcProportion | number | optional | A+ product share (%) Example: 1 |
data.data[].returnRatio | number | optional | Return rate (%) Example: 1 |
data.data[].avgReturnRatio | number | optional | Category average return rate (%) Example: 1 |
data.data[].searchToPurchaseRatio | number | optional | Search-to-purchase ratio (per mille) Example: 1 |
data.data[].sellerNation | string | optional | Most common seller location code Example: null |
data.data[].sellerNationLabel | string | optional | Most common seller location label Example: null |
data.data[].sellerProportion | number | optional | Most common seller location share (%) Example: 1 |
data.data[].avgWeight | number | optional | Average weight (pound) Example: 1 |
data.data[].baseAvgWeight | number | optional | Average weight (g) Example: 1 |
data.data[].avgVolume | number | optional | Average volume (in³) Example: 1 |
data.data[].baseAvgVolume | number | optional | Average volume (cm³) Example: 1 |
data.data[].top10Images | array | optional | Top 10 product images, elements see table below Example: [] |
data.data[].top10Images[] | object | required | Item in data data[] top10Images. |
data.data[].top10Images[].image | string | optional | Image link Example: https://example.com/image.jpg |
data.data[].top10Images[].asin | string | optional | ASIN Example: B072MQ5BRX |
data.columns | array | optional | Render columns Example: [] |
data.costToken | integer | optional | Tokens consumed Example: 1 |
data.type | string | optional | Render style Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |