POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-product-detail/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-detail/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`asins`	`string`	required	ASIN list, supports batch query, up to 40 ASINs. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$. Example: B072MQ5BRX,B08N5WRWNW Example: B072MQ5BRX
`amazonDomain`	`string`	optional	Amazon country site, default amazon.com. Options: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.co.jp, amazon.ca, amazon.com.au, amazon.com.br, amazon.in, amazon.nl, amazon.se, amazon.pl, amazon.sg, amazon.sa, amazon.ae, amazon.com.tr, amazon.com.mx, amazon.eg, amazon.cn, amazon.com.be
`language`	`string`	optional	Language. Examples: en_US, de_DE, fr_FR, ja_JP, it_IT, es_ES, pt_BR, en_GB, zh_CN
`deliveryZip`	`string`	optional	Delivery zip code, used to get delivery-related pricing. Examples: 10001 (New York, US), 10115 (Berlin, Germany), EC1A 1BB (London, UK)

Code example

{
  "returnAuthorsReviews": false,
  "returnRelatedProducts": false,
  "returnBoughtTogether": false,
  "asins": "B072MQ5BRX"
}

Response example

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

{
  "data": {
    "total": 1,
    "columns": [],
    "costToken": 1,
    "products": [
      {
        "asin": "B072MQ5BRX",
        "price": 1,
        "extractedPrice": 1,
        "oldPrice": 1,
        "extractedOldPrice": 1,
        "rating": 1,
        "ratings": 1,
        "prime": false,
        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
        "imageUrl": "https://example.com/image.jpg",
        "productImageUrls": [],
        "aboutItem": [],
        "climatePledgeFriendly": false,
        "snapEbtEligible": false,
        "boughtLastMonthCount": 1,
        "reviewsImages": [],
        "pageFileUrl": "https://example.com/product.json",
        "rawHtmlFile": "https://example.com/product.html"
      }
    ]
  },
  "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.columns

array

optional

Rendered columns

Example: []

data.type

string

optional

Render style

Example: null

data.costToken

integer

optional

Token consumption

Example: 1

data.products

array

optional

Product list (see below)

Example: []

data.products[]

object

required

Item in data products.

data.products[].asin

string

optional

ASIN code

Example: B072MQ5BRX

data.products[].title

string

optional

Product title

Example: null

data.products[].brand

string

optional

Brand

Example: null

data.products[].price

number

optional

Price

Example: 1

data.products[].extractedPrice

number

optional

Extracted price

Example: 1

data.products[].oldPrice

number

optional

Original price

Example: 1

data.products[].extractedOldPrice

number

optional

Extracted original price

Example: 1

data.products[].currency

string

optional

Currency

Example: null

data.products[].discount

string

optional

Discount

Example: null

data.products[].saveWithCoupon

string

optional

Amount saved with coupon

Example: null

data.products[].rating

number

optional

Rating

Example: 1

data.products[].ratings

integer

optional

Number of reviews

Example: 1

data.products[].prime

boolean

optional

Whether it is a Prime item

Example: false

data.products[].stock

string

optional

Stock status

Example: null

data.products[].delivery

string

optional

Delivery information

Example: null

data.products[].link

string

optional

Product link

Example: null

data.products[].linkClean

string

optional

Clean link

Example: null

data.products[].asinUrl

string

optional

Amazon ASIN link

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

data.products[].imageUrl

string

optional

Thumbnail

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

data.products[].thumbnail

string

optional

Thumbnail

Example: null

data.products[].productImageUrls

array

optional

Product image URL list

Example: []

data.products[].aboutItem

array

optional

Bullet points

Example: []

data.products[].productDescription

string

optional

Product description; when A+ content exists, this is a JSON string (see A+ structure below)

Example: null

data.products[].description

string

optional

Product description

Example: null

data.products[].dimension

string

optional

Product dimensions

Example: null

data.products[].weight

string

optional

Weight

Example: null

data.products[].tags

string

optional

Tag list

Example: null

data.products[].badges

string

optional

Badge list

Example: null

data.products[].climatePledgeFriendly

boolean

optional

Whether it is Climate Pledge Friendly

Example: false

data.products[].snapEbtEligible

boolean

optional

Whether SNAP EBT eligible

Example: false

data.products[].boughtLastMonth

string

optional

Units bought last month (string)

Example: null

data.products[].boughtLastMonthCount

integer

optional

Units bought last month (number)

Example: 1

data.products[].reviewsSummary

string

optional

Review summary

Example: null

data.products[].reviewsImages

array

optional

Review image list

Example: []

data.products[].sourceTool

string

optional

Source tool

Example: null

data.products[].sourceType

string

optional

Source type: amazon

Example: null

data.products[].pageFileUrl

string

optional

Processed product JSON file URL; not raw HTML

Example: https://example.com/product.json

data.products[].rawHtmlFile

string

optional

Raw Amazon product-page HTML URL from the upstream provider; optional and matched to the containing product ASIN

Example: https://example.com/product.html

data.products[].productDetails

object

optional

Detailed product specifications.

Example: null

data.products[].productDetails.asin

string

optional

ASIN code.

Example: null

data.products[].productDetails.manufacturer

string

optional

Manufacturer.

Example: null

data.products[].productDetails.productDimensions

string

optional

Product dimensions.

Example: null

data.products[].productDetails.upc

string

optional

UPC code.

Example: null

data.products[].productDetails.units

string

optional

Units.

Example: null

data.products[].productDetails.rating

number

optional

Rating.

Example: null

data.products[].productDetails.review

integer

optional

Number of reviews.

Example: null

data.products[].customerReviews

object

optional

Star rating distribution.

Example: null

data.products[].customerReviews.fiveStar

integer

optional

Five-star review count.

Example: null

data.products[].customerReviews.fourStar

integer

optional

Four-star review count.

Example: null

data.products[].customerReviews.threeStar

integer

optional

Three-star review count.

Example: null

data.products[].customerReviews.twoStar

integer

optional

Two-star review count.

Example: null

data.products[].customerReviews.oneStar

integer

optional

One-star review count.

Example: null

data.products[].variants

array

optional

Product variant groups.

Example: null

data.products[].variants[]

object

required

Item in data products[] variants.

data.products[].variants[].title

string

optional

Variant group title, such as color or size.

Example: null

data.products[].variants[].items

array

optional

Variant items.

Example: null

data.products[].variants[].items[]

object

required

Item in data products[] variants[] items.

data.products[].variants[].items[].name

string

optional

Variant name.

Example: null

data.products[].variants[].items[].asin

string

optional

Variant ASIN.

Example: null

data.products[].variants[].items[].position

integer

optional

Variant position.

Example: null

data.products[].variants[].items[].selected

boolean

optional

Whether this variant is selected.

Example: null

data.products[].itemSpecifications

object

optional

Dynamic product specification keys and values.

Example: null

data.products[].itemIngredients

array

optional

Product ingredients.

Example: null

data.products[].boughtTogether

array

optional

Frequently bought together items when requested.

Example: null

data.products[].boughtTogether[]

object

required

Item in data products[] boughtTogether.

data.products[].boughtTogether[].asin

string

optional

Related ASIN.

Example: null

data.products[].boughtTogether[].title

string

optional

Amazon Product Detail

What this API does

Amazon Product Detail

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