Amazon Marketplace Intelligence

Amazon Reviews List

Fetch and analyze Amazon product reviews by ASIN, supporting 15 marketplaces (including US) with star rating filtering. Triggered when users mention Amazon reviews, US reviews, product reviews, buyer complaints, negative reviews, positive reviews, star ratings, review analysis, review sentiment, product improvement suggestions, Vine reviews, verified purchase reviews, competitor review research, Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review analysis, positive review analysis, star rating filter, review sentiment analysis, product improvement insights, Vine reviews, competitor reviews, customer feedback. Even if users do not explicitly say "reviews", this skill should be triggered whenever the task involves reading, filtering, or analyzing Amazon product customer reviews.

post/api/skill-api/v1/skills/amazon-reviews-list/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-reviews-list/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 product ASIN

domainCodestring

Amazon domain code, default com. Options: com, ca, co.uk, in, de, fr, it, es, co.jp, com.au, com.br, nl, se, com.mx, ae. Use com for the US site

star1Numinteger

Number of 1-star reviews, default 10, max 100

star2Numinteger

Number of 2-star reviews, default 10, max 100

star3Numinteger

Number of 3-star reviews, default 10, max 100

star4Numinteger

Number of 4-star reviews, default 10, max 100

star5Numinteger

Number of 5-star reviews, default 10, max 100

filterByKeywordstring

Filter reviews by keyword, max length 1000 characters

sortBystring

Review sort order: recent (most recent reviews) or helpful (most helpful reviews), default recent

reviewerTypestring

Reviewer type: all_reviews (all reviews) or avp_only_reviews (verified purchases only), default all_reviews

mediaTypestring

Media type: all_contents (all content) or media_reviews_only (reviews with media only), default all_contents

formatTypestring

Format type: all_formats (all formats) or current_format (current format), default all_formats

Example request

{
  "star4Num": 1,
  "domainCode": "com",
  "asin": "B072MQ5BRX",
  "star5Num": 1,
  "star1Num": 1,
  "star2Num": 1,
  "star3Num": 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": {
    "total": 1,
    "data": [],
    "costToken": 1
  }
}

Changes

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