Amazon Marketplace Intelligence

Amazon Market Product Detail MCP Tool

Query Amazon product detail and historical trends by ASIN using Sorftime data, covering 14 marketplaces.

MCP tool name

nexscope_amazon_market_product_detail

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-market-product-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_product_detail",
    "arguments": {
      "includeTrend": 1,
      "asin": "B072MQ5BRX",
      "marketplace": "us",
      "queryTrendEndDate": "2026-01-15",
      "queryTrendStartDate": "2026-01-01"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-market-product-detail

Arguments

Name	Type	Required	Meaning
`asin`	`string`	required	Amazon Standard Identification Number (ASIN), supports multiple (max 10), comma-separated. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ Example: B072MQ5BRX
`marketplace`	`string`	required	Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa Example: us
`includeTrend`	`integer`	optional	Whether to include trend data. 1: include (default); 2: exclude Example: 1
`queryTrendStartDate`	`string`	optional	Trend start date, format yyyy-MM-dd. Default returns only the last 15 days; querying more than 15 days doubles the cost Example: 2026-01-01
`queryTrendEndDate`	`string`	optional	Trend end date, format yyyy-MM-dd Example: 2026-01-15

Response fields

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.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.total`	`integer`	optional	Total result count Example: 1
`data.costTime`	`integer`	optional	Latency (ms) Example: 1
`data.costToken`	`integer`	optional	Tokens consumed Example: 1
`data.requestConsumed`	`integer`	optional	Requests consumed Example: 1
`data.sourceType`	`string`	optional	Source type: sorftime Example: null
`data.type`	`string`	optional	Render style Example: null
`data.columns`	`array`	optional	Render columns Example: []
`data.products`	`array`	optional	Product detail list (see below) Example: []
`data.products[].asin`	`string`	optional	ASIN Example: B072MQ5BRX
`data.products[].title`	`string`	optional	Product title Example: null
`data.products[].brand`	`string`	optional	Brand Example: null
`data.products[].asinUrl`	`string`	optional	Product link, Amazon Listing detail page URL Example: B072MQ5BRX
`data.products[].imageUrl`	`string`	optional	Main image URL Example: https://example.com/image.jpg
`data.products[].productImageUrls`	`array`	optional	Main image list (all product image URLs) Example: []
`data.products[].ebcPhoto`	`array`	optional	A+ image list Example: []
`data.products[].storeName`	`string`	optional	Store name Example: null
`data.products[].description`	`string`	optional	Five bullet points Example: null
`data.products[].productBadge`	`array`	optional	Product badges, e.g. Amazon Choice, Best Seller, New Release, etc. Example: []
`data.products[].lastUpdate`	`string`	optional	Update time, most recent ASIN data collection time (format yyyy-MM-dd) Example: 2026-01-01
`data.products[].offSale`	`boolean`	optional	Whether delisted. true = unavailable, false = available Example: false
`data.products[].productType`	`string`	optional	Category, Amazon product category node name Example: null
`data.products[].weight`	`string`	optional	Weight, unit g Example: null
`data.products[].size`	`array`	optional	Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm Example: []
`data.products[].parentAsin`	`string`	optional	Parent ASIN, the parent ASIN if variants exist, null if no variants Example: B072MQ5BRX
`data.products[].variationNum`	`integer`	optional	Number of variations Example: 1
`data.products[].variationASIN`	`array`	optional	Child ASIN list, empty if no variants Example: []
`data.products[].attribute`	`array`	optional	Product attributes, variant attributes if variants exist. Each entry contains asin (child ASIN), name (attribute name), value (attribute value) Example: []
`data.products[].price`	`number`	optional	Selling price, actual price after coupon deduction, in local currency (e.g. USD) Example: 1
`data.products[].coupon`	`integer`	optional	Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount) Example: 1
`data.products[].platformFee`	`number`	optional	Platform commission, in local currency (e.g. USD) Example: 1
`data.products[].fbaFees`	`number`	optional	FBA fees, in local currency (e.g. USD) Example: 1
`data.products[].fbaDetail`	`array`	optional	FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,"1-9:5","10-12:15"] Example: []
`data.products[].shipCost`	`number`	optional	FBM shipping cost, in local currency (e.g. USD) Example: 1
`data.products[].shipsFrom`	`string`	optional	Ship-from location Example: null
`data.products[].profitAmount`	`number`	optional	Profit, final price - FBA fee - commission, in local currency (e.g. USD) Example: 1
`data.products[].profitRate`	`number`	optional	Profit margin, e.g. 25.83 means 25.83% Example: 1
`data.products[].monthlySalesUnits`	`integer`	optional	Official monthly sales volume, Amazon published ASIN monthly sales, latest value from the last 7 calendar days, 0 if unavailable Example: 1
`data.products[].salesRank`	`integer`	optional	BSR rank, main category rank Example: 1
`data.products[].category`	`array`	optional	Main category, [category name, NodeId] Example: []
`data.products[].bsrCategory`	`array`	optional	Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd) Example: []
`data.products[].availableDate`	`string`	optional	Listing time, format yyyy-MM-dd Example: 2026-01-01
`data.products[].onlineDays`	`integer`	optional	Days since listing Example: 1
`data.products[].rating`	`number`	optional	Current rating (0.0-5.0, e.g. 4.70) Example: 1
`data.products[].ratings`	`integer`	optional	Number of ratings Example: 1
`data.products[].fiveStarRatings`	`number`	optional	5-star percentage, e.g. 57.7 means 57.7% Example: 1
`data.products[].fourStarRatings`	`number`	optional	4-star percentage Example: 1
`data.products[].threeStarRatings`	`number`	optional	3-star percentage Example: 1
`data.products[].twoStarRatings`	`number`	optional	2-star percentage Example: 1
`data.products[].oneStarRatings`	`number`	optional	1-star percentage Example: 1
`data.products[].buyboxSeller`	`string`	optional	Buybox seller name Example: null
`data.products[].buyBoxSellerId`	`string`	optional	Buybox seller ID Example: example-id
`data.products[].buyboxSellerAddress`	`string`	optional	Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own Example: null
`data.products[].isFBA`	`boolean`	optional	Whether FBA, whether Buybox seller uses FBA logistics Example: false
`data.products[].sellerNum`	`integer`	optional	Number of sellers Example: 1
`data.products[].aPlus`	`boolean`	optional	Has A+ Example: false
`data.products[].hasVideo`	`boolean`	optional	Has video Example: false
`data.products[].hasBrandStore`	`boolean`	optional	Has brand store Example: false
`data.products[].feature`	`object`	optional	Product feature ratings, features and star ratings collected by Amazon for this product, e.g. {"Battery life":4.0} Example: {}
`data.products[].productInfo`	`object`	optional	Product information, structured data from the Product Information section in the Listing Example: {}
`data.products[].property`	`object`	optional	Attribute list, including variant attributes and Bullet Points header descriptions Example: {}
`data.products[].brandPromotion`	`string`	optional	Brand promotion Example: null
`data.products[].dealType`	`string`	optional	Deal label Example: null
`data.products[].extraSavings`	`array`	optional	Associated promotions, e.g. [{Asin:xxx, Text:"Save 5%..."}] Example: []
`data.products[].rankTrend`	`array`	optional	BSR trend, main category rank change history, interleaved format [date, rank, ...] Example: []
`data.products[].bsrRankTrend`	`array`	optional	Subcategory rank trend, JSON format [{NodeId:xxx, Rank:[date, rank, ...]}] Example: []
`data.products[].listingSalesVolumeOfDailyTrend`	`array`	optional	Daily sales volume trend, value -1 means unable to estimate Example: []
`data.products[].listingSalesOfDailyTrend`	`array`	optional	Daily sales revenue trend, in local currency smallest unit (e.g. cents), value -1 means unable to estimate Example: []
`data.products[].listingSalesVolumeOfMonthTrend`	`array`	optional	Monthly sales volume trend (last 30 days), value -1 means unable to estimate Example: []
`data.products[].listingSalesOfMonthTrend`	`array`	optional	Monthly sales revenue trend, in local currency smallest unit (e.g. cents) Example: []
`data.products[].priceTrend`	`array`	optional	Selling price trend, before coupon, in local currency smallest unit, -1 means no price available for that day Example: []
`data.products[].listPriceTrend`	`array`	optional	Original price trend (strikethrough price history), in local currency smallest unit, -1 means no price available for that day Example: []
`data.products[].dealTrend`	`array`	optional	Deal trend, value 1 = has deal, 0 = no deal Example: []
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. 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

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "includeTrend": 1,
  "asin": "B072MQ5BRX",
  "marketplace": "us",
  "queryTrendEndDate": "2026-01-15",
  "queryTrendStartDate": "2026-01-01"
}

Example structuredContent

{
  "data": {
    "total": 1,
    "costTime": 1,
    "costToken": 1,
    "requestConsumed": 1,
    "columns": [],
    "products": [
      {
        "asin": "B072MQ5BRX",
        "asinUrl": "B072MQ5BRX",
        "imageUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "ebcPhoto": [],
        "productBadge": [],
        "lastUpdate": "2026-01-01",
        "offSale": false,
        "size": [],
        "parentAsin": "B072MQ5BRX",
        "variationNum": 1,
        "variationASIN": [],
        "attribute": [],
        "price": 1,
        "coupon": 1,
        "platformFee": 1,
        "fbaFees": 1,
        "fbaDetail": [],
        "shipCost": 1,
        "profitAmount": 1,
        "profitRate": 1,
        "monthlySalesUnits": 1,
        "salesRank": 1,
        "category": [],
        "bsrCategory": [],
        "availableDate": "2026-01-01",
        "onlineDays": 1,
        "rating": 1,
        "ratings": 1,
        "fiveStarRatings": 1,
        "fourStarRatings": 1,
        "threeStarRatings": 1,
        "twoStarRatings": 1,
        "oneStarRatings": 1,
        "buyBoxSellerId": "example-id",
        "isFBA": false,
        "sellerNum": 1,
        "aPlus": false,
        "hasVideo": false,
        "hasBrandStore": false,
        "feature": {},
        "productInfo": {},
        "property": {},
        "extraSavings": [],
        "rankTrend": [],
        "bsrRankTrend": [],
        "listingSalesVolumeOfDailyTrend": [],
        "listingSalesOfDailyTrend": [],
        "listingSalesVolumeOfMonthTrend": [],
        "listingSalesOfMonthTrend": [],
        "priceTrend": [],
        "listPriceTrend": [],
        "dealTrend": []
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}