Amazon
Query Amazon product historical time-series data, including price trends, BSR (Best Sellers Rank) trends, rating changes, seller counts, and monthly sales, supporting any ASIN across multiple Amazon marketplaces.
nexscope_amazon_product_price_serieshttps://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-product-price-series-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_price_series",
"arguments": {
"days": 90,
"asin": "B072MQ5BRX",
"showPrice": 1,
"showPricePrime": 1,
"showPriceList": 1,
"domain": "1",
"showPriceDeal": 1
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/amazon-product-price-seriesProgress 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 |
|---|---|---|---|
asin | string | required | Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000 Example: B072MQ5BRX |
domain | string | required | Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil) Example: 1 |
days | integer | optional | Limit historical data to this many days, default 90, max 365 Example: 90 |
showPrice | integer | optional | Set to 1 to return the lowest new price curve in the market Example: 1 |
showPriceList | integer | optional | Set to 1 to return the list/strikethrough price curve Example: 1 |
showPriceDeal | integer | optional | Set to 1 to return the deal/flash sale price curve Example: 1 |
showPricePrime | integer | optional | Set to 1 to return the Prime-exclusive new price curve Example: 1 |
showPriceFba | integer | optional | Set to 1 to return the third-party FBA new price curve Example: 1 |
showPriceFbm | integer | optional | Set to 1 to return the third-party FBM new price curve Example: 1 |
showPriceCoupon | integer | optional | Set to 1 to return the coupon-applied Buy Box price curve Example: 1 |
showBsrMain | integer | optional | Set to 1 to return the main category BSR curve Example: 1 |
showSellerCount | integer | optional | Set to 1 to return the seller count curve 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.asin | string | optional | ASIN Example: B072MQ5BRX |
data.buyboxPrice | array | optional | Buy Box price (time=timestamp, value=Buy Box price) Example: [] |
data.price | array | optional | Price (time=timestamp, value=price) Example: [] |
data.priceList | array |
{
"days": 90,
"asin": "B072MQ5BRX",
"showPrice": 1,
"showPricePrime": 1,
"showPriceList": 1,
"domain": "1",
"showPriceDeal": 1
}{
"data": {
"asin": "B072MQ5BRX",
"buyboxPrice": [],
"price": [],
"priceList": [],
"priceDeal": [],
"pricePrime": [],
"priceFba": [],
"priceFbm": [],
"priceCoupon": [],
"bsrMain": [],
"bsrSub": [],
"sellerCount": [],
"rating": [],
"ratingCount": [],
"monthlySold": [],
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}List/strikethrough price (time=timestamp, value=list price) Example: [] |
data.priceDeal | array | optional | Deal price (time=timestamp, value=deal price) Example: [] |
data.pricePrime | array | optional | Prime price (time=timestamp, value=Prime price) Example: [] |
data.priceFba | array | optional | FBA price (time=timestamp, value=FBA price) Example: [] |
data.priceFbm | array | optional | FBM price (time=timestamp, value=FBM price) Example: [] |
data.priceCoupon | array | optional | Coupon price (time=timestamp, value=coupon price) Example: [] |
data.bsrMain | array | optional | Main category BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking) Example: [] |
data.bsrSub | array | optional | Subcategory BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking) Example: [] |
data.sellerCount | array | optional | Seller count (time=timestamp, value=seller count) Example: [] |
data.rating | array | optional | Rating (time=timestamp, value=rating) Example: [] |
data.ratingCount | array | optional | Rating count (time=timestamp, value=rating count) Example: [] |
data.monthlySold | array | optional | Child ASIN sales (time=timestamp, value=sales units) Example: [] |
data.costToken | integer | optional | Token consumption Example: 1 |
data.type | string | optional | Provider-specific render or payload type. 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. |