Amazon History KP
Amazon Product History MCP
Retrieve Amazon product attributes and up to 12 months of sales history by ASIN. Call the Amazon Product History API via REST or MCP with your Nexscope API key.
Amazon Product History AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Get Product Information Without History
Prompt: Look up up to 5 Amazon products [ASINS] in [MARKETPLACE]. Return product information without historical data.
2. Check Historical Product Data
Prompt: Look up up to 5 Amazon products [ASINS] in [MARKETPLACE]. Include the available product history and historical sales, retaining the source’s dates and estimates.
3. Review Monthly Sales Estimates
Prompt: Look up up to 5 Amazon products [ASINS] in [MARKETPLACE]. Include the available product history and historical sales, retaining the source’s dates and estimates. Compare the returned monthly sales estimates across the available month labels. Keep missing months blank and distinguish estimates from actual orders.
4. Inspect Fulfillment And Fee Evidence
Prompt: Look up up to 5 Amazon products [ASINS] in [MARKETPLACE]. Return product information without historical data. Show fulfillment, FBA fee and referral-fee information with the returned price and currency. State missing cost inputs; do not claim a complete profit calculation.
5. Review Listing And Variation Structure
Prompt: Look up up to 5 Amazon products [ASINS] in [MARKETPLACE]. Return product information without historical data. Summarize the parent ASIN, variation count, brand, material, dimensions and image references. Preserve measurement labels rather than assuming units.
What You Need to Provide
Replace the bracketed placeholders with your own research inputs. Keep source estimates, reporting periods and missing information explicit.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_amazon_product_historyhttps://api.nexscope.ai/mcptools/callInitialize 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 HTTPProgress 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. |
perPage | integer | optional | Quantity per page. |
sourceType | string | optional | Source type: `kp`. |
columns | array | optional | Rendered columns. |
costToken | integer | optional | Consume token. |
totalCount | integer | optional | Total quantity. |
currentPage | integer | optional | Current page number. |
type | string | optional | Rendering style. |
products | array | optional | Product list, element fields are shown in the table below. |
asin | string | optional | ASIN。 |
title | string | optional | Product title. |
brand | string | optional | brand. |
manufacturer | string | optional | manufacturer. |
model | string | optional | model. |
color | string | optional | color. |
material | string | optional | The material of a product refers to the main materials used in its construction. |
price | number | optional | Current price in local currency. |
primePrice | number | optional | Prime Price. |
currency | string | optional | Currency. |
rating | number | optional | Current rating (0.0-5.0). |
ratings | integer | optional | Number of ratings. |
reviewCount | integer | optional | Number of comments. |
salesRank | integer | optional | Sales ranking. |
salesRank30 | integer | optional | Average sales rank over the past 30 days. |
salesRank90 | integer | optional | Average sales rank over the last 90 days. |
salesRank180 | integer | optional | Average sales rank over the last 180 days. |
monthlySalesUnits | integer | optional | Monthly sales volume. |
monthlySalesRevenue | number | optional | Monthly sales. |
monthlySalesUnits1MonthAgo | integer | optional | Monthly sales volume 1 months ago. |
monthlySalesUnits2MonthsAgo | integer | optional | Monthly sales volume 2 months ago. |
monthlySalesUnits3MonthsAgo | integer | optional | Monthly sales volume 3 months ago. |
monthlySalesUnits4MonthsAgo | integer | optional | Monthly sales volume 4 months ago. |
monthlySalesUnits5MonthsAgo | integer | optional | Monthly sales volume 5 months ago. |
monthlySalesUnits6MonthsAgo | integer | optional | Monthly sales volume 6 months ago. |
monthlySalesUnits7MonthsAgo | integer | optional | Monthly sales volume 7 months ago. |
monthlySalesUnits8MonthsAgo | integer | optional | Monthly sales volume 8 months ago. |
monthlySalesUnits9MonthsAgo | integer | optional | Monthly sales volume 9 months ago. |
monthlySalesUnits10MonthsAgo | integer | optional | Monthly sales volume 10 months ago. |
monthlySalesUnits11MonthsAgo | integer | optional | Monthly sales volume 11 months ago. |
monthlySalesUnits12MonthsAgo | integer | optional | Monthly sales volume 12 months ago. |
availableDate | string | optional | Shelf time (`yyyy-MM-dd HH:mm:ss`). |
lastUpdate | string | optional | Last updated time (`yyyy-MM-dd HH:mm:ss`). |
imageUrl | string | optional | Image URL (request address). |
productImageUrls | array | optional | List of product images. |
asinUrl | string | optional | Amazon ASIN details URL. |
urlSlug | string | optional | URL Slug。 |
itemLength | integer | optional | Product length in millimeters, or 0 or -1 if not available. |
itemWidth | integer | optional | Product width in millimeters, 0 or -1 if not available. |
itemHeight | integer | optional | Product height in millimeters, 0 or -1 if not available. |
dimension | string | optional | size. |
dimensionsType | string | optional | Size type. |
weight | string | optional | Weight (grams). |
packageLength | integer | optional | Package length (mm). |
packageWidth | integer | optional | Package width (mm). |
packageHeight | integer | optional | Package height (mm). |
packageWeight | string | optional | Packing weight (grams). |
packageDimensions | string | optional | Packaging size. |
packageQuantity | integer | optional | The quantity of the item in the package, or 0 or -1 if not available. |
fulfillment | string | optional | Delivery method: `AMZ`, `FBA`, `FBM`. |
fbaFees | number | optional | FBA fulfillment fee in local currency. |
referralFeePercentage | number | optional | Referral fee percentage. |
profit | number | optional | Profit margin (percentage, such as 25.5 for 25.5%). |
buyBoxSellerId | string | optional | Buy button seller ID. |
sellerNum | integer | optional | Number of sellers. |
variationNum | integer | optional | Number of variants. |
parentAsin | string | optional | Parent ASIN. |
rootCategory | integer | optional | Root category ID. |
categoryTree | string | optional | Category tree. |
categoryTreeId | string | optional | Category tree ID. |
subcategories | array | optional | List of subcategories; each element contains `code` (category ID), `rank` (ranking), `label` (category name). |
isAdultProduct | boolean | optional | Whether it is an adult product. |
isHazmat | boolean | optional | Whether it is dangerous goods. |
sourceType | string | optional | Source type: `kp`. |
code | — | optional | Category ID; element type shall be subject to the source file or upstream official documentation. |
rank | — | optional | Ranking; element type shall be based on the source file or upstream official documentation. |
label | — | optional | Category name; element type shall be subject to the source file or upstream official documentation. |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Show the historical product metrics for ASIN B072MQ5BRX on Amazon US.
Illustrative Response Explanation
The illustrative result reports 300 monthly sales units and 250 for the one-month-ago metric. The difference is 50 units; these observations do not establish a long-term trend.
About this sample: Illustrative example only. Names, identifiers and numbers are fictional; no live tool call was made. Your results depend on your account, inputs and available data.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "amazon-product-history-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_history",
"arguments": {
"asin": "B072MQ5BRX",
"domain": "1",
"history": 1
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-product-history-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"products\":[{\"asin\":\"B072MQ5BRX\",\"title\":\"Example phone case\",\"monthlySalesUnits\":300,\"monthlySalesUnits1MonthAgo\":250}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"products": [
{
"asin": "B072MQ5BRX",
"title": "Example phone case",
"monthlySalesUnits": 300,
"monthlySalesUnits1MonthAgo": 250
}
]
}
},
"isError": false
}
}