--- title: "getItemReviewTopics" method: GET path: "/customerFeedback/2024-06-01/items/{asin}/reviews/topics" tags: ["Customer Feedback v2024-06-01"] --- # getItemReviewTopics `GET /customerFeedback/2024-06-01/items/{asin}/reviews/topics` Retrieve an item's ten most positive and ten most negative review topics. ## Path parameters - `asin` string, required ## Query parameters - `marketplaceId` string, required - `sortBy` string, required ## Response `200` Success. - ItemReviewTopicsResponse — The response for the `getItemReviewTopics` operation. - `asin` string, required — The requested ASIN. The Amazon Standard Identification Number (ASIN) is the unique identifier of a product within a marketplace. - `itemName` string, required — The product title of the requested ASIN. - `marketplaceId` string, required — The requested marketplace id. - `countryCode` string, required — The two digit country code of the requested marketplace id, in ISO 3166-1 alpha-2 format. - `dateRange` DateRange, required — The time range within which something (for example, a delivery) will occur. - `earliest` string, date-time, required — Date-time formatted timestamp. - `latest` string, date-time, required — Date-time formatted timestamp. - `topics` ItemReviewTopics, required — The top 10 positive and negative item review topics. - `positiveTopics` ItemReviewTopic[] — A list of the most positive review topics. When the `sortBy` query parameter is set to `MENTIONS`, the number of reviews that mention the topic determines the topic's placement in the list. When `sortBy` is set to `STAR_RATING_IMPACT`, the effect that the topic has on the star rating of the item determines placement in the list. This value is `null` if there are not enough positive reviews for the specified ASIN. **Max length:** 10 - `topic` string, required — The name of the item review topic. - `asinMetrics` ItemReviewTopicMetrics, required — The item review topic metrics. - `numberOfMentions` integer — The number of times that reviews mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `occurrencePercentage` number, float — The percentage of customer reviews that mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `starRatingImpact` number, float — The effect of the topic on the star rating of the ASIN. This value can be positive or negative. This value is `null` if the topic does't affect the star rating of the ASIN. - `parentAsinMetrics` ItemReviewTopicMetrics — The item review topic metrics. - `numberOfMentions` integer — The number of times that reviews mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `occurrencePercentage` number, float — The percentage of customer reviews that mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `starRatingImpact` number, float — The effect of the topic on the star rating of the ASIN. This value can be positive or negative. This value is `null` if the topic does't affect the star rating of the ASIN. - `browseNodeMetrics` ItemReviewBrowseNodeMetrics — The browse node review topic metrics. - `occurrencePercentage` BrowseNodeOccurrence — The browse node review trend occurrence metrics. - `allProducts` number, float, required — The percentage of reviews of products in the browse node that mention a topic. - `starRatingImpact` BrowseNodeStarRatingImpact — The effects of a topic on a browse node's star rating. - `allProducts` number, float, required — The effect of the topic on the star rating for all products in this browse node. This value can be positive or negative. - `childAsinMetrics` ChildAsinMetrics — The review topic metrics for other child ASINs that have the same parent ASIN. This value is `null` if there isn't any child ASIN metric data. - `mostMentions` ChildAsinMentionMetrics — The child ASIN review topic mention metrics. - `asin` string, required — The child ASIN of the requested item. - `numberOfMentions` integer, required — The number of times reviews of the child ASIN mention the topic. - `leastMentions` ChildAsinMentionMetrics — The child ASIN review topic mention metrics. - `asin` string, required — The child ASIN of the requested item. - `numberOfMentions` integer, required — The number of times reviews of the child ASIN mention the topic. - `reviewSnippets` string[] — A list of up to three snippets from reviews that contain the topic. This value is `null` if there aren't enough review snippets for the topic. - `subtopics` ItemReviewSubtopic[] — A list of up to five top subtopics for the topic. The percentage of customer reviews that mention the subtopic determine the topic's placement in the list. This value is `null` if there are no subtopics. - `subtopic` string, required — The name of the subtopic. - `metrics` ItemReviewSubtopicMetrics, required — The item review subtopic metrics. - `numberOfMentions` integer, required — The number of times that reviews mention the subtopic. - `occurrencePercentage` number, float, required — The percentage of reviews that mention the subtopic. - `reviewSnippets` string[] — A list of up to three snippets from reviews that contain the subtopic. This value is `null` if there aren't enough review snippets for the subtopic. - `negativeTopics` ItemReviewTopic[] — A list of the most negative review topics. When the `sortBy` query parameter is set to `MENTIONS`, the number of reviews that mention the topic determines the topic's placement in the list. When `sortBy` is set to `STAR_RATING_IMPACT`, the effect that the topic has on the star rating of the item determines placement in the list. This value is `null` if there are not enough negative reviews for the specified ASIN. **Max length:** 10 - `topic` string, required — The name of the item review topic. - `asinMetrics` ItemReviewTopicMetrics, required — The item review topic metrics. - `numberOfMentions` integer — The number of times that reviews mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `occurrencePercentage` number, float — The percentage of customer reviews that mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `starRatingImpact` number, float — The effect of the topic on the star rating of the ASIN. This value can be positive or negative. This value is `null` if the topic does't affect the star rating of the ASIN. - `parentAsinMetrics` ItemReviewTopicMetrics — The item review topic metrics. - `numberOfMentions` integer — The number of times that reviews mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `occurrencePercentage` number, float — The percentage of customer reviews that mention the topic. This value is `null` if reviews do not mention the topic frequently enough. - `starRatingImpact` number, float — The effect of the topic on the star rating of the ASIN. This value can be positive or negative. This value is `null` if the topic does't affect the star rating of the ASIN. - `browseNodeMetrics` ItemReviewBrowseNodeMetrics — The browse node review topic metrics. - `occurrencePercentage` BrowseNodeOccurrence — The browse node review trend occurrence metrics. - `allProducts` number, float, required — The percentage of reviews of products in the browse node that mention a topic. - `starRatingImpact` BrowseNodeStarRatingImpact — The effects of a topic on a browse node's star rating. - `allProducts` number, float, required — The effect of the topic on the star rating for all products in this browse node. This value can be positive or negative. - `childAsinMetrics` ChildAsinMetrics — The review topic metrics for other child ASINs that have the same parent ASIN. This value is `null` if there isn't any child ASIN metric data. - `mostMentions` ChildAsinMentionMetrics — The child ASIN review topic mention metrics. - `asin` string, required — The child ASIN of the requested item. - `numberOfMentions` integer, required — The number of times reviews of the child ASIN mention the topic. - `leastMentions` ChildAsinMentionMetrics — The child ASIN review topic mention metrics. - `asin` string, required — The child ASIN of the requested item. - `numberOfMentions` integer, required — The number of times reviews of the child ASIN mention the topic. - `reviewSnippets` string[] — A list of up to three snippets from reviews that contain the topic. This value is `null` if there aren't enough review snippets for the topic. - `subtopics` ItemReviewSubtopic[] — A list of up to five top subtopics for the topic. The percentage of customer reviews that mention the subtopic determine the topic's placement in the list. This value is `null` if there are no subtopics. - `subtopic` string, required — The name of the subtopic. - `metrics` ItemReviewSubtopicMetrics, required — The item review subtopic metrics. - `numberOfMentions` integer, required — The number of times that reviews mention the subtopic. - `occurrencePercentage` number, float, required — The percentage of reviews that mention the subtopic. - `reviewSnippets` string[] — A list of up to three snippets from reviews that contain the subtopic. This value is `null` if there aren't enough review snippets for the subtopic. ## Other responses - `204` — Success. - `400` — Request has missing or invalid parameters and cannot be parsed. - `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. - `404` — The resource specified does not exist. - `413` — The request size exceeded the maximum accepted size. - `415` — The request payload is in an unsupported format. - `429` — The frequency of requests was greater than allowed. - `500` — An unexpected condition occurred that prevented the server from fulfilling the request. - `503` — Temporary overloading or maintenance of the server. --- [API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)