Amazon History KP

Amazon Product Price Series

Track an Amazon product's price, best-seller rank, ratings, and sales over time. Call via REST API or MCP from 10 credits per call.

MCP tool name

nexscope_amazon_product_price_series

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-product-price-series-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_price_series",
    "arguments": {
      "asin": "B072MQ5BRX",
      "days": 90,
      "domain": "1",
      "showPrice": 1,
      "showPriceDeal": 1,
      "showPriceList": 1,
      "showPricePrime": 1
    }
  }
}

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
`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

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`asin`	`string`	optional	ASIN。 Example: {}
`buyboxPrice`	`array`	optional	Buy Box price; elements contain `time` (time) and `value` (Buy Box price). Example: {}
`price`	`array`	optional	The lowest new product price on the market; elements include `time` and `value`. Example: {}
`priceList`	`array`	optional	Strikethrough price; elements contain `time` and `value`. Example: {}
`priceDeal`	`array`	optional	Deal price; elements contain `time` and `value`. Example: {}
`pricePrime`	`array`	optional	Prime price; elements contain `time` and `value`. Example: {}
`priceFba`	`array`	optional	FBA price; elements contain `time` and `value`. Example: {}
`priceFbm`	`array`	optional	FBM price; elements contain `time` and `value`. Example: {}
`priceCoupon`	`array`	optional	Coupon price; elements contain `time` and `value`. Example: {}
`bsrMain`	`array`	optional	Category BSR; each element contains `categoryName` (category name) and `points` (time series point). Example: {}
`bsrSub`	`array`	optional	Small class BSR; each element contains `categoryName` (category name) and `points` (time series point). Example: {}
`sellerCount`	`array`	optional	Number of sellers; elements contain `time` and `value`. Example: {}
`rating`	`array`	optional	Rating; elements contain `time` and `value`. Example: {}
`ratingCount`	`array`	optional	Score number; elements contain `time` and `value`. Example: {}
`monthlySold`	`array`	optional	Subbody sales; elements contain `time` and `value`. Example: {}
`costToken`	`integer`	optional	Consume token. Example: {}
`time`	`—`	optional	Time; the specific type shall be subject to the source file or upstream official documentation. Example: {}
`value`	`—`	optional	The indicator value corresponding to the time point; the specific type shall be subject to the source file or upstream official documentation. Example: {}
`categoryName`	`—`	optional	Category name; the specific type shall be subject to the source file or upstream official documentation. Example: {}
`points`	`—`	optional	This category is a BSR time series point, and the elements include `time` and `value`; the specific type is subject to the source file or the upstream official document. Example: {}

Examples

Example arguments

{
  "asin": "B072MQ5BRX",
  "days": 90,
  "domain": "1",
  "showPrice": 1,
  "showPriceDeal": 1,
  "showPriceList": 1,
  "showPricePrime": 1
}

Example structuredContent

{}