Amazon Public Marketplace Data

Amazon Reviews List

Retrieve customer reviews for an Amazon product. Call the Amazon Reviews List API via REST or MCP from 58 credits per call.

MCP tool name

nexscope_amazon_reviews_list

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "amazon-reviews-list-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_reviews_list",
    "arguments": {
      "asin": "B072MQ5BRX",
      "domainCode": "com",
      "star1Num": 1,
      "star2Num": 1,
      "star3Num": 1,
      "star4Num": 1,
      "star5Num": 1
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`asin`	`string`	required	Amazon product ASIN Example: B072MQ5BRX
`domainCode`	`string`	optional	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 Example: {}
`star1Num`	`integer`	optional	Number of 1-star reviews, default 10, max 100 Example: 1
`star2Num`	`integer`	optional	Number of 2-star reviews, default 10, max 100 Example: 1
`star3Num`	`integer`	optional	Number of 3-star reviews, default 10, max 100 Example: 1
`star4Num`	`integer`	optional	Number of 4-star reviews, default 10, max 100 Example: 1
`star5Num`	`integer`	optional	Number of 5-star reviews, default 10, max 100 Example: 1
`filterByKeyword`	`string`	optional	Filter reviews by keyword, max length 1000 characters Example: phone case
`sortBy`	`string`	optional	Review sort order: recent (most recent reviews) or helpful (most helpful reviews), default recent Example: {}
`reviewerType`	`string`	optional	Reviewer type: all_reviews (all reviews) or avp_only_reviews (verified purchases only), default all_reviews Example: {}
`mediaType`	`string`	optional	Media type: all_contents (all content) or media_reviews_only (reviews with media only), default all_contents Example: {}
`formatType`	`string`	optional	Format type: all_formats (all formats) or current_format (current format), default all_formats Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Total number of comments. Example: {}
`data`	`array`	optional	Comments list. Example: {}
`columns`	`array`	optional	Rendered columns. Example: {}
`costToken`	`integer`	optional	Total Token consumption. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`reviewId`	`string`	optional	Comment ID. Example: {}
`asin`	`string`	optional	Product ASIN. Example: {}
`title`	`string`	optional	Comment title. Example: {}
`text`	`string`	optional	Comment content. Example: {}
`rating`	`string`	optional	Rating. Example: {}
`date`	`string`	optional	Date of review. Example: {}
`userName`	`string`	optional	Commenter name. Example: {}
`verified`	`boolean`	optional	Has the purchase been verified? Example: {}
`vine`	`boolean`	optional	Vine Voice Reviews or Not. Example: {}
`numberOfHelpful`	`integer`	optional	Useful quantity. Example: {}
`imageUrlList`	`array`	optional	Comment picture list. Example: {}
`videoUrlList`	`array`	optional	Comment video list. Example: {}
`domainCode`	`string`	optional	Country code. Example: {}
`productTitle`	`string`	optional	Product title. Example: {}
`productRating`	`string`	optional	Product Ratings. Example: {}
`countRatings`	`integer`	optional	Number of product ratings. Example: {}
`countReviews`	`integer`	optional	Number of product reviews. Example: {}
`variationId`	`string`	optional	Variant ID. Example: {}
`variationList`	`array`	optional	Variation list. Example: {}
`profilePath`	`string`	optional	Commenter profile path. Example: {}
`currentPage`	`integer`	optional	Current page number. Example: {}
`sortStrategy`	`string`	optional	Sorting strategy. Example: {}
`statusCode`	`integer`	optional	status code. Example: {}
`statusMessage`	`string`	optional	status message. Example: {}
`locale`	`object`	optional	Regional information. Example: {}
`reviewSummary`	`object`	optional	Review summary data. Example: {}
`filters`	`object`	optional	Filters applied. Example: {}

Examples

Example arguments

{
  "asin": "B072MQ5BRX",
  "domainCode": "com",
  "star1Num": 1,
  "star2Num": 1,
  "star3Num": 1,
  "star4Num": 1,
  "star5Num": 1
}

Example structuredContent

{}