POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-history/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-history/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

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

Code example

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

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "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 00:00:00",
        "lastUpdate": "2026-01-01 00:00:00",
        "imageUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
        "urlSlug": "example-product",
        "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
}

Response fields

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`

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Name

Type

Required

Description

data

object

required

Data value used by this API operation.

data.total

integer

optional

Total rows

Example: 1

data.perPage

integer

optional

Items per page

Example: 1

data.sourceType

string

optional

Source type: keepa

Example: null

data.columns

array

optional

Rendered columns

Example: []

data.costToken

integer

optional

Token consumption

Example: 1

data.totalCount

integer

optional

Total count

Example: 1

data.currentPage

integer

optional

Current page number

Example: 1

data.type

string

optional

Render style

Example: null

data.products

array

optional

Product list (see below)

Example: []

data.products[]

object

required

Item in data products.

data.products[].asin

string

optional

ASIN

Example: B072MQ5BRX

data.products[].title

string

optional

Product title

Example: null

data.products[].itemHighlights

string

optional

Short Item Highlights separate from the title; up to 125 characters and may be null, blank, or absent

Example: null

data.products[].brand

string

optional

Brand

Example: null

data.products[].manufacturer

string

optional

Manufacturer

Example: null

data.products[].model

string

optional

Model

Example: null

data.products[].color

string

optional

Color

Example: null

data.products[].material

string

optional

Product material, the primary material used in its construction

Example: null

data.products[].price

number

optional

Current price (in local currency, e.g., USD/EUR)

Example: 1

data.products[].primePrice

number

optional

Prime price

Example: 1

data.products[].currency

string

optional

Currency

Example: null

data.products[].rating

number

optional

Current rating (0.0-5.0, e.g., 4.5 stars)

Example: 1

data.products[].ratings

integer

optional

Number of ratings

Example: 1

data.products[].reviewCount

integer

optional

Number of reviews

Example: 1

data.products[].salesRank

integer

optional

Sales rank

Example: 1

data.products[].salesRank30

integer

optional

Average sales rank in last 30 days

Example: 1

data.products[].salesRank90

integer

optional

Average sales rank in last 90 days

Example: 1

data.products[].salesRank180

integer

optional

Average sales rank in last 180 days

Example: 1

data.products[].monthlySalesUnits

integer

optional

Monthly sales units

Example: 1

data.products[].monthlySalesRevenue

number

optional

Monthly sales revenue

Example: 1

data.products[].monthlySalesUnits1MonthAgo

integer

optional

Monthly sales 1 month ago

Example: 1

data.products[].monthlySalesUnits2MonthsAgo

integer

optional

Monthly sales 2 months ago

Example: 1

data.products[].monthlySalesUnits3MonthsAgo

integer

optional

Monthly sales 3 months ago

Example: 1

data.products[].monthlySalesUnits4MonthsAgo

integer

optional

Monthly sales 4 months ago

Example: 1

data.products[].monthlySalesUnits5MonthsAgo

integer

optional

Monthly sales 5 months ago

Example: 1

data.products[].monthlySalesUnits6MonthsAgo

integer

optional

Monthly sales 6 months ago

Example: 1

data.products[].monthlySalesUnits7MonthsAgo

integer

optional

Monthly sales 7 months ago

Example: 1

data.products[].monthlySalesUnits8MonthsAgo

integer

optional

Monthly sales 8 months ago

Example: 1

data.products[].monthlySalesUnits9MonthsAgo

integer

optional

Monthly sales 9 months ago

Example: 1

data.products[].monthlySalesUnits10MonthsAgo

integer

optional

Monthly sales 10 months ago

Example: 1

data.products[].monthlySalesUnits11MonthsAgo

integer

optional

Monthly sales 11 months ago

Example: 1

data.products[].monthlySalesUnits12MonthsAgo

integer

optional

Monthly sales 12 months ago

Example: 1

data.products[].availableDate

string

optional

Listing time (yyyy-MM-dd HH:mm:ss)

Example: 2026-01-01 00:00:00

data.products[].lastUpdate

string

optional

Last update time (yyyy-MM-dd HH:mm:ss)

Example: 2026-01-01 00:00:00

data.products[].imageUrl

string

optional

Image URL (request address)

Example: https://example.com/image.jpg

data.products[].productImageUrls

array

optional

Product image list

Example: []

data.products[].asinUrl

string

optional

Amazon ASIN detail page URL

Example: https://www.amazon.com/dp/B072MQ5BRX

data.products[].urlSlug

string

optional

URL slug

Example: example-product

data.products[].itemLength

integer

optional

Item length in millimeters, 0 or -1 if unavailable

Example: 1

data.products[].itemWidth

integer

optional

Item width in millimeters, 0 or -1 if unavailable

Example: 1

data.products[].itemHeight

integer

optional

Item height in millimeters, 0 or -1 if unavailable

Example: 1

data.products[].dimension

string

optional

Dimensions

Example: null

data.products[].dimensionsType

string

optional

Dimensions type

Example: null

data.products[].weight

string

optional

Weight (grams)

Example: null

data.products[].packageLength

integer

optional

Package length (mm)

Example: 1

data.products[].packageWidth

integer

optional

Package width (mm)

Example: 1

data.products[].packageHeight

integer

optional

Package height (mm)

Example: 1

data.products[].packageWeight

string

optional

Package weight (grams)

Example: null

data.products[].packageDimensions

string

optional

Package dimensions

Example: null

data.products[].packageQuantity

integer

optional

Quantity of items in the package, 0 or -1 if unavailable

Example: 1

data.products[].fulfillment

string

optional

Fulfillment method (AMZ, FBA, FBM)

Example: null

data.products[].fbaFees

number

optional

FBA fulfillment fee (in local currency)

Example: 1

data.products[].referralFeePercentage

number

optional

Referral fee percentage

Example: 1

data.products[].profit

number

optional

Profit margin (percentage, e.g., 25.5 means 25.5%)

Example: 1

data.products[].buyBoxSellerId

string

optional

Buy Box seller ID

Example: example-id

data.products[].sellerNum

integer

optional

Number of sellers

Example: 1

data.products[].variationNum

integer

optional

Number of variations

Example: 1

data.products[].parentAsin

string

optional

Parent ASIN

Example: B072MQ5BRX

data.products[].rootCategory

integer

optional

Root category ID

Example: 1

data.products[].categoryTree

string

optional

Category tree

Example: null

data.products[].categoryTreeId

string

optional

Category tree ID

Example: example-id

data.products[].subcategories

array

optional

Subcategory list, each element contains code (category ID), rank (ranking), label (category name)

Example: []

data.products[].isAdultProduct

boolean

optional

Whether it is an adult product

Example: false

data.products[].isHazmat

boolean

optional

Whether it is hazardous material

Example: false

data.products[].sourceType

string

optional

Source type: keepa

Example: null

data.products[].sourceTool

string

optional

Source tool

Example: null

data.title

string

optional

Provider-specific response title.

Example: null

data.sourceTool

string

optional

Provider-specific source tool name.

Example: null

data.costTime

integer

optional

Execution time reported by the upstream provider.

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

Name

Type

Required

Description

data

null

required

Data value used by this API operation.

Amazon Product History

What this API does

Amazon Product History

What this API does

Authentication

Run an API

Example request

Check the response

HTTP status codes

Run this API

Endpoint

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Legacy MCP v1

Online test

Try it

Related APIs

Any of option 1

Any of option 2