Amazon History KP

Amazon Product History

Retrieve Amazon product attributes and up to 12 months of sales history by ASIN. Call the Amazon Product History API via REST or MCP from 10 credits per call.

MCP tool name

nexscope_amazon_product_history

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-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_history",
    "arguments": {
      "asin": "B072MQ5BRX",
      "domain": "1",
      "history": 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), multiple ASINs separated by English commas, up to 5, max length 300 characters. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ,B07M68S376 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
`history`	`integer`	optional	Whether to include historical data and historical sales in the response. 1 = include price history, sales rank, historical sales and other time-series data (sales for previous months), 0 = return only basic product information. Default: 0 Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of rows. Example: {}
`perPage`	`integer`	optional	Quantity per page. Example: {}
`sourceType`	`string`	optional	Source type: `kp`. Example: {}
`columns`	`array`	optional	Rendered columns. Example: {}
`costToken`	`integer`	optional	Consume token. Example: {}
`totalCount`	`integer`	optional	Total quantity. Example: {}
`currentPage`	`integer`	optional	Current page number. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`products`	`array`	optional	Product list, element fields are shown in the table below. Example: {}
`asin`	`string`	optional	ASIN。 Example: {}
`title`	`string`	optional	Product title. Example: {}
`brand`	`string`	optional	brand. Example: {}
`manufacturer`	`string`	optional	manufacturer. Example: {}
`model`	`string`	optional	model. Example: {}
`color`	`string`	optional	color. Example: {}
`material`	`string`	optional	The material of a product refers to the main materials used in its construction. Example: {}
`price`	`number`	optional	Current price in local currency. Example: {}
`primePrice`	`number`	optional	Prime Price. Example: {}
`currency`	`string`	optional	Currency. Example: {}
`rating`	`number`	optional	Current rating (0.0-5.0). Example: {}
`ratings`	`integer`	optional	Number of ratings. Example: {}
`reviewCount`	`integer`	optional	Number of comments. Example: {}
`salesRank`	`integer`	optional	Sales ranking. Example: {}
`salesRank30`	`integer`	optional	Average sales rank over the past 30 days. Example: {}
`salesRank90`	`integer`	optional	Average sales rank over the last 90 days. Example: {}
`salesRank180`	`integer`	optional	Average sales rank over the last 180 days. Example: {}
`monthlySalesUnits`	`integer`	optional	Monthly sales volume. Example: {}
`monthlySalesRevenue`	`number`	optional	Monthly sales. Example: {}
`monthlySalesUnits1MonthAgo`	`integer`	optional	Monthly sales volume 1 months ago. Example: {}
`monthlySalesUnits2MonthsAgo`	`integer`	optional	Monthly sales volume 2 months ago. Example: {}
`monthlySalesUnits3MonthsAgo`	`integer`	optional	Monthly sales volume 3 months ago. Example: {}
`monthlySalesUnits4MonthsAgo`	`integer`	optional	Monthly sales volume 4 months ago. Example: {}
`monthlySalesUnits5MonthsAgo`	`integer`	optional	Monthly sales volume 5 months ago. Example: {}
`monthlySalesUnits6MonthsAgo`	`integer`	optional	Monthly sales volume 6 months ago. Example: {}
`monthlySalesUnits7MonthsAgo`	`integer`	optional	Monthly sales volume 7 months ago. Example: {}
`monthlySalesUnits8MonthsAgo`	`integer`	optional	Monthly sales volume 8 months ago. Example: {}
`monthlySalesUnits9MonthsAgo`	`integer`	optional	Monthly sales volume 9 months ago. Example: {}
`monthlySalesUnits10MonthsAgo`	`integer`	optional	Monthly sales volume 10 months ago. Example: {}
`monthlySalesUnits11MonthsAgo`	`integer`	optional	Monthly sales volume 11 months ago. Example: {}
`monthlySalesUnits12MonthsAgo`	`integer`	optional	Monthly sales volume 12 months ago. Example: {}
`availableDate`	`string`	optional	Shelf time (`yyyy-MM-dd HH:mm:ss`). Example: {}
`lastUpdate`	`string`	optional	Last updated time (`yyyy-MM-dd HH:mm:ss`). Example: {}
`imageUrl`	`string`	optional	Image URL (request address). Example: {}
`productImageUrls`	`array`	optional	List of product images. Example: {}
`asinUrl`	`string`	optional	Amazon ASIN details URL. Example: {}
`urlSlug`	`string`	optional	URL Slug。 Example: {}
`itemLength`	`integer`	optional	Product length in millimeters, or 0 or -1 if not available. Example: {}
`itemWidth`	`integer`	optional	Product width in millimeters, 0 or -1 if not available. Example: {}
`itemHeight`	`integer`	optional	Product height in millimeters, 0 or -1 if not available. Example: {}
`dimension`	`string`	optional	size. Example: {}
`dimensionsType`	`string`	optional	Size type. Example: {}
`weight`	`string`	optional	Weight (grams). Example: {}
`packageLength`	`integer`	optional	Package length (mm). Example: {}
`packageWidth`	`integer`	optional	Package width (mm). Example: {}
`packageHeight`	`integer`	optional	Package height (mm). Example: {}
`packageWeight`	`string`	optional	Packing weight (grams). Example: {}
`packageDimensions`	`string`	optional	Packaging size. Example: {}
`packageQuantity`	`integer`	optional	The quantity of the item in the package, or 0 or -1 if not available. Example: {}
`fulfillment`	`string`	optional	Delivery method: `AMZ`, `FBA`, `FBM`. Example: {}
`fbaFees`	`number`	optional	FBA fulfillment fee in local currency. Example: {}
`referralFeePercentage`	`number`	optional	Referral fee percentage. Example: {}
`profit`	`number`	optional	Profit margin (percentage, such as 25.5 for 25.5%). Example: {}
`buyBoxSellerId`	`string`	optional	Buy button seller ID. Example: {}
`sellerNum`	`integer`	optional	Number of sellers. Example: {}
`variationNum`	`integer`	optional	Number of variants. Example: {}
`parentAsin`	`string`	optional	Parent ASIN. Example: {}
`rootCategory`	`integer`	optional	Root category ID. Example: {}
`categoryTree`	`string`	optional	Category tree. Example: {}
`categoryTreeId`	`string`	optional	Category tree ID. Example: {}
`subcategories`	`array`	optional	List of subcategories; each element contains `code` (category ID), `rank` (ranking), `label` (category name). Example: {}
`isAdultProduct`	`boolean`	optional	Whether it is an adult product. Example: {}
`isHazmat`	`boolean`	optional	Whether it is dangerous goods. Example: {}
`sourceType`	`string`	optional	Source type: `kp`. Example: {}
`code`	`—`	optional	Category ID; element type shall be subject to the source file or upstream official documentation. Example: {}
`rank`	`—`	optional	Ranking; element type shall be based on the source file or upstream official documentation. Example: {}
`label`	`—`	optional	Category name; element type shall be subject to the source file or upstream official documentation. Example: {}

Examples

Example arguments

{
  "asin": "B072MQ5BRX",
  "domain": "1",
  "history": 1
}

Example structuredContent

{}