Amazon
Use SellerSprite market statistics capability to output a market statistics dashboard by category node, including top listing average rating, average price, BSR, sales, seller count, and new product related metrics, suitable for quickly assessing the market quality and competitive landscape of a category.
nexscope_amazon_market_statisticshttps://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-statistics-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_statistics",
"arguments": {
"marketplace": "US",
"nodeIdPath": "1064954:1069242",
"topN": 10,
"newProduct": 6
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/amazon-market-statisticsProgress 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 | required | Node ID path string, e.g. 1064954:1069242:1069784:1069820:1069838:1069828 Example: 1064954:1069242 |
month | string | optional | Filter date: nearly or yyyyMM Example: {} |
topN | integer | optional | Top Listing count (used for top-related metric definitions) Example: 10 |
newProduct | integer | optional | New product definition (months) Example: 6 |
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 | Statistics result list (corresponds to third-party data) Example: [] |
data.data[] | object | required |
{
"marketplace": "US",
"nodeIdPath": "1064954:1069242",
"topN": 10,
"newProduct": 6
}{
"data": {
"total": 1,
"marketplace": "US",
"data": [
{
"marketplace": "US",
"totalProducts": 1,
"products": 1,
"sellers": 1,
"brands": 1,
"avgSellers": 1,
"hlProducts": 1,
"avgUnits": 1,
"avgRevenue": 1,
"avgPrice": 1,
"avgRating": 1,
"avgRatings": 1,
"avgRatingsCv": 1,
"avgBsr": 1,
"avgProfit": 1,
"avgWeight": 1,
"baseAvgWeight": 1,
"avgVolume": 1,
"baseAvgVolume": 1,
"hlAvgUnits": 1,
"hlAvgRevenue": 1,
"hlAvgPrice": 1,
"hlAvgRating": 1,
"hlAvgRatings": 1,
"hlAvgRatingsCv": 1,
"hlAvgBsr": 1,
"newProducts": 1,
"newProductProportion": 1,
"newAvgUnits": 1,
"newAvgRevenue": 1,
"newAvgPrice": 1,
"newAvgRating": 1,
"newAvgRatings": 1,
"minNewRatings": 1,
"maxNewRatings": 1,
"firstShelfDate": "2026-01-01",
"lastShelfDate": "2026-01-01"
}
],
"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[].marketplace | string | optional | Site code for this statistics row Example: US |
data.data[].nodeIdPath | string | optional | Node ID path 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[].countryCode | string | optional | Two-letter country code Example: null |
data.data[].currency | string | optional | Currency type for this market Example: null |
data.data[].totalProducts | integer | optional | Total product count Example: 1 |
data.data[].products | integer | optional | Sample product 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[].hlProducts | integer | optional | Top N Listing sample product count Example: 1 |
data.data[].avgUnits | integer | optional | Average monthly sales volume Example: 1 |
data.data[].avgRevenue | number | optional | Average monthly sales revenue Example: 1 |
data.data[].avgPrice | number | optional | Average price Example: 1 |
data.data[].avgRating | number | optional | Average star rating Example: 1 |
data.data[].avgRatings | integer | optional | Average review count Example: 1 |
data.data[].avgRatingsCv | integer | optional | Average monthly review growth count Example: 1 |
data.data[].avgBsr | integer | optional | Average BSR Example: 1 |
data.data[].avgProfit | number | optional | Average profit margin 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[].hlAvgUnits | integer | optional | Top N Listing average monthly sales volume Example: 1 |
data.data[].hlAvgRevenue | number | optional | Top N Listing average monthly sales revenue Example: 1 |
data.data[].hlAvgPrice | number | optional | Top N Listing average price Example: 1 |
data.data[].hlAvgRating | number | optional | Top N Listing average star rating Example: 1 |
data.data[].hlAvgRatings | integer | optional | Top N Listing average review count Example: 1 |
data.data[].hlAvgRatingsCv | integer | optional | Top N Listing average monthly review growth count Example: 1 |
data.data[].hlAvgBsr | integer | optional | Top N Listing average BSR Example: 1 |
data.data[].newProducts | integer | optional | New product count Example: 1 |
data.data[].newProductProportion | number | optional | New product share Example: 1 |
data.data[].newAvgUnits | integer | optional | New product average monthly sales volume Example: 1 |
data.data[].newAvgRevenue | number | optional | New product average monthly sales revenue Example: 1 |
data.data[].newAvgPrice | number | optional | New product average price Example: 1 |
data.data[].newAvgRating | number | optional | New product average star rating Example: 1 |
data.data[].newAvgRatings | integer | optional | New product average review count Example: 1 |
data.data[].minNewRatings | integer | optional | Minimum new product review count Example: 1 |
data.data[].maxNewRatings | integer | optional | Maximum new product review count Example: 1 |
data.data[].firstShelfDate | string | optional | Product first listing date Example: 2026-01-01 |
data.data[].lastShelfDate | string | optional | Product latest listing date Example: 2026-01-01 |
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. |