Nexscope
Start free

Amazon Marketplace Intelligence

Amazon Product History MCP Tool

Retrieve Amazon product details by ASIN, including price, title, Item Highlights when available, main image, listing date, material, weight, variant monthly sales, and up to 12 months of monthly sales history.

MCP tool name
nexscope_amazon_product_history
Legacy MCP endpoint
/api/skill-api/v1/mcp
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

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-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_history",
    "arguments": {
      "history": 1,
      "domain": "1",
      "asin": "B072MQ5BRX"
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-product-history

Arguments

NameTypeRequiredMeaning
asinstringrequired
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
domainstringrequired
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
historyintegeroptional
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.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.totalintegeroptional
Total rows
Example: 1
data.perPageintegeroptional
Items per page
Example: 1
data.sourceTypestringoptional
Source type: keepa
Example: null
data.columnsarrayoptional
Rendered columns
Example: []
data.costTokenintegeroptional
Token consumption
Example: 1
data.totalCountintegeroptional
Total count
Example: 1
data.currentPageintegeroptional
Current page number
Example: 1
data.typestringoptional
Render style
Example: null
data.productsarrayoptional
Product list (see below)
Example: []
data.products[].asinstringoptional
ASIN
Example: B072MQ5BRX
data.products[].titlestringoptional
Product title
Example: null
data.products[].itemHighlightsstringoptional
Short Item Highlights separate from the title; up to 125 characters and may be null, blank, or absent
Example: null
data.products[].brandstringoptional
Brand
Example: null
data.products[].manufacturerstringoptional
Manufacturer
Example: null
data.products[].modelstringoptional
Model
Example: null
data.products[].colorstringoptional
Color
Example: null
data.products[].materialstringoptional
Product material, the primary material used in its construction
Example: null
data.products[].pricenumberoptional
Current price (in local currency, e.g., USD/EUR)
Example: 1
data.products[].primePricenumberoptional
Prime price
Example: 1
data.products[].currencystringoptional
Currency
Example: null
data.products[].ratingnumberoptional
Current rating (0.0-5.0, e.g., 4.5 stars)
Example: 1
data.products[].ratingsintegeroptional
Number of ratings
Example: 1
data.products[].reviewCountintegeroptional
Number of reviews
Example: 1
data.products[].salesRankintegeroptional
Sales rank
Example: 1
data.products[].salesRank30integeroptional
Average sales rank in last 30 days
Example: 1
data.products[].salesRank90integeroptional
Average sales rank in last 90 days
Example: 1
data.products[].salesRank180integeroptional
Average sales rank in last 180 days
Example: 1
data.products[].monthlySalesUnitsintegeroptional
Monthly sales units
Example: 1
data.products[].monthlySalesRevenuenumberoptional
Monthly sales revenue
Example: 1
data.products[].monthlySalesUnits1MonthAgointegeroptional
Monthly sales 1 month ago
Example: 1
data.products[].monthlySalesUnits2MonthsAgointegeroptional
Monthly sales 2 months ago
Example: 1
data.products[].monthlySalesUnits3MonthsAgointegeroptional
Monthly sales 3 months ago
Example: 1
data.products[].monthlySalesUnits4MonthsAgointegeroptional
Monthly sales 4 months ago
Example: 1
data.products[].monthlySalesUnits5MonthsAgointegeroptional
Monthly sales 5 months ago
Example: 1
data.products[].monthlySalesUnits6MonthsAgointegeroptional
Monthly sales 6 months ago
Example: 1
data.products[].monthlySalesUnits7MonthsAgointegeroptional
Monthly sales 7 months ago
Example: 1
data.products[].monthlySalesUnits8MonthsAgointegeroptional
Monthly sales 8 months ago
Example: 1
data.products[].monthlySalesUnits9MonthsAgointegeroptional
Monthly sales 9 months ago
Example: 1
data.products[].monthlySalesUnits10MonthsAgointegeroptional
Monthly sales 10 months ago
Example: 1
data.products[].monthlySalesUnits11MonthsAgointegeroptional
Monthly sales 11 months ago
Example: 1
data.products[].monthlySalesUnits12MonthsAgointegeroptional
Monthly sales 12 months ago
Example: 1
data.products[].availableDatestringoptional
Listing time (yyyy-MM-dd HH:mm:ss)
Example: 2026-01-01
data.products[].lastUpdatestringoptional
Last update time (yyyy-MM-dd HH:mm:ss)
Example: 2026-01-01
data.products[].imageUrlstringoptional
Image URL (request address)
Example: https://example.com/image.jpg
data.products[].productImageUrlsarrayoptional
Product image list
Example: []
data.products[].asinUrlstringoptional
Amazon ASIN detail page URL
Example: B072MQ5BRX
data.products[].urlSlugstringoptional
URL slug
Example: https://example.com/image.jpg
data.products[].itemLengthintegeroptional
Item length in millimeters, 0 or -1 if unavailable
Example: 1
data.products[].itemWidthintegeroptional
Item width in millimeters, 0 or -1 if unavailable
Example: 1
data.products[].itemHeightintegeroptional
Item height in millimeters, 0 or -1 if unavailable
Example: 1
data.products[].dimensionstringoptional
Dimensions
Example: null
data.products[].dimensionsTypestringoptional
Dimensions type
Example: null
data.products[].weightstringoptional
Weight (grams)
Example: null
data.products[].packageLengthintegeroptional
Package length (mm)
Example: 1
data.products[].packageWidthintegeroptional
Package width (mm)
Example: 1
data.products[].packageHeightintegeroptional
Package height (mm)
Example: 1
data.products[].packageWeightstringoptional
Package weight (grams)
Example: null
data.products[].packageDimensionsstringoptional
Package dimensions
Example: null
data.products[].packageQuantityintegeroptional
Quantity of items in the package, 0 or -1 if unavailable
Example: 1
data.products[].fulfillmentstringoptional
Fulfillment method (AMZ, FBA, FBM)
Example: null
data.products[].fbaFeesnumberoptional
FBA fulfillment fee (in local currency)
Example: 1
data.products[].referralFeePercentagenumberoptional
Referral fee percentage
Example: 1
data.products[].profitnumberoptional
Profit margin (percentage, e.g., 25.5 means 25.5%)
Example: 1
data.products[].buyBoxSellerIdstringoptional
Buy Box seller ID
Example: example-id
data.products[].sellerNumintegeroptional
Number of sellers
Example: 1
data.products[].variationNumintegeroptional
Number of variations
Example: 1
data.products[].parentAsinstringoptional
Parent ASIN
Example: B072MQ5BRX
data.products[].rootCategoryintegeroptional
Root category ID
Example: 1
data.products[].categoryTreestringoptional
Category tree
Example: null
data.products[].categoryTreeIdstringoptional
Category tree ID
Example: example-id
data.products[].subcategoriesarrayoptional
Subcategory list, each element contains code (category ID), rank (ranking), label (category name)
Example: []
data.products[].isAdultProductbooleanoptional
Whether it is an adult product
Example: false
data.products[].isHazmatbooleanoptional
Whether it is hazardous material
Example: false
data.products[].sourceTypestringoptional
Source type: keepa
Example: null
data.products[].sourceToolstringoptional
Source tool
Example: null
data.titlestringoptional
Provider-specific response title.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "total": 1,
    "perPage": 1,
    "columns": [],
    "costToken": 1,
    "totalCount": 1,
    "currentPage": 1,
    "products": [
      {
        "asin": "B072MQ5BRX",
        "price": 1,
        "primePrice": 1,
        "rating": 1,
        "ratings": 1,
        "reviewCount": 1,
        "salesRank": 1,
        "salesRank30": 1,
        "salesRank90": 1,
        "salesRank180": 1,
        "monthlySalesUnits": 1,
        "monthlySalesRevenue": 1,
        "monthlySalesUnits1MonthAgo": 1,
        "monthlySalesUnits2MonthsAgo": 1,
        "monthlySalesUnits3MonthsAgo": 1,
        "monthlySalesUnits4MonthsAgo": 1,
        "monthlySalesUnits5MonthsAgo": 1,
        "monthlySalesUnits6MonthsAgo": 1,
        "monthlySalesUnits7MonthsAgo": 1,
        "monthlySalesUnits8MonthsAgo": 1,
        "monthlySalesUnits9MonthsAgo": 1,
        "monthlySalesUnits10MonthsAgo": 1,
        "monthlySalesUnits11MonthsAgo": 1,
        "monthlySalesUnits12MonthsAgo": 1,
        "availableDate": "2026-01-01",
        "lastUpdate": "2026-01-01",
        "imageUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "asinUrl": "B072MQ5BRX",
        "urlSlug": "https://example.com/image.jpg",
        "itemLength": 1,
        "itemWidth": 1,
        "itemHeight": 1,
        "packageLength": 1,
        "packageWidth": 1,
        "packageHeight": 1,
        "packageQuantity": 1,
        "fbaFees": 1,
        "referralFeePercentage": 1,
        "profit": 1,
        "buyBoxSellerId": "example-id",
        "sellerNum": 1,
        "variationNum": 1,
        "parentAsin": "B072MQ5BRX",
        "rootCategory": 1,
        "categoryTreeId": "example-id",
        "subcategories": [],
        "isAdultProduct": false,
        "isHazmat": false
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}