Amazon Public Marketplace Data

Amazon Public Marketplace Data: reviews/list API

Amazon Public Marketplace Data: reviews/list API.

MCP tool name

nexscope_data_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": "data-amazon-reviews-list-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_amazon_reviews_list",
    "arguments": {
      "asin": "B08N5WRWNW",
      "domainCode": "com",
      "reviewerType": "all_reviews",
      "sortBy": "recent",
      "star1Num": 10,
      "star2Num": 10,
      "star3Num": 0,
      "star4Num": 0,
      "star5Num": 0
    }
  }
}

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; only one ASIN is supported per request. Example: {}
`domainCode`	`string`	optional	Site code: `com`, `ca`, `co.uk`, `in`, `de`, `fr`, `it`, `es`, `co.jp`, `com.au`, `com.br`, `nl`, `se`, `com.mx`, `ae`. Example: com
`star1Num`	`integer`	optional	Number of 1-star reviews, maximum 100. Example: 10
`star2Num`	`integer`	optional	Number of 2-star reviews, maximum 100. Example: 10
`star3Num`	`integer`	optional	Number of 3-star reviews, maximum 100. Example: 10
`star4Num`	`integer`	optional	Number of 4-star reviews, maximum 100. Example: 10
`star5Num`	`integer`	optional	Number of 5-star reviews, maximum 100. Example: 10
`filterByKeyword`	`string`	optional	Filter comments by keyword, maximum length 1000 characters. Example: {}
`sortBy`	`string`	optional	Sort by: `recent` (newest comment) or `helpful` (most useful comment). Example: recent
`reviewerType`	`string`	optional	Reviewer type: `all_reviews` (all reviews) or `avp_only_reviews` (certified purchases only). Example: all_reviews
`mediaType`	`string`	optional	Media type: `all_contents` (all content) or `media_reviews_only` (comments with media only). Example: all_contents
`formatType`	`string`	optional	Format type: `all_formats` (all formats) or `current_format` (current format). Example: all_formats

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": "B08N5WRWNW",
  "domainCode": "com",
  "reviewerType": "all_reviews",
  "sortBy": "recent",
  "star1Num": 10,
  "star2Num": 10,
  "star3Num": 0,
  "star4Num": 0,
  "star5Num": 0
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}