Amazon Marketplace Intelligence

Amazon Product Price Series

Query Amazon product historical time-series data, including price trends, BSR (Best Sellers Rank) trends, rating changes, seller counts, and monthly sales, supporting any ASIN across multiple Amazon marketplaces. Triggered when users mention price history, price tracking, BSR history, BSR trends, historical pricing, price fluctuations, Nexscope data, rank history, price drop alerts, lightning deal historical prices, Buy Box price trends, coupon prices, FBA/FBM price comparison, seller count changes, rating trends, sales history. Even if users do not explicitly mention "Nexscope" or "time-series data", this skill should be triggered whenever the task involves analyzing Amazon product-level historical data (such as price, rank, or sales trends over time).

post/api/skill-api/v1/skills/amazon-product-price-series/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-price-series/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

asinstring required

Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000

domainstring 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)

daysinteger

Limit historical data to this many days, default 90, max 365

showPriceinteger

Set to 1 to return the lowest new price curve in the market

showPriceListinteger

Set to 1 to return the list/strikethrough price curve

showPriceDealinteger

Set to 1 to return the deal/flash sale price curve

showPricePrimeinteger

Set to 1 to return the Prime-exclusive new price curve

showPriceFbainteger

Set to 1 to return the third-party FBA new price curve

showPriceFbminteger

Set to 1 to return the third-party FBM new price curve

showPriceCouponinteger

Set to 1 to return the coupon-applied Buy Box price curve

showBsrMaininteger

Set to 1 to return the main category BSR curve

showSellerCountinteger

Set to 1 to return the seller count curve

Example request

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

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "asin": "B072MQ5BRX",
    "costToken": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.