--- title: "getBrowseNodeReviewTopics" method: GET path: "/customerFeedback/2024-06-01/browseNodes/{browseNodeId}/reviews/topics" tags: ["Customer Feedback v2024-06-01"] --- # getBrowseNodeReviewTopics `GET /customerFeedback/2024-06-01/browseNodes/{browseNodeId}/reviews/topics` ## Request - Base URL: `https://sellingpartnerapi-na.amazon.com` - URL: `https://sellingpartnerapi-na.amazon.com/customerFeedback/2024-06-01/browseNodes/{browseNodeId}/reviews/topics` - Auth: none declared Retrieve a browse node's ten most positive and ten most negative review topics. ## Path parameters - `browseNodeId` string, required ## Query parameters - `marketplaceId` string, required - `sortBy` string, required ## Response `200` Success. - BrowseNodeReviewTopicsResponse: The response for the `getBrowseNodeReviewTopics` operation. - `browseNodeId` string, required: The requested browse node id. A browse node id is the unique identifier of a given browse node. - `displayName` string, required: The display name of the requested browse node id. The display name of the browse node as visible on the Amazon retail website. - `marketplaceId` string, required: The requested marketplace id. - `countryCode` string, required: The two digit country code of 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` BrowseNodeReviewTopics, required: The 10 most positive and most negative review topics for all items in a browse node. - `positiveTopics` BrowseNodeReviewTopic[]: A list of the most positive review topics. When the `sortBy` query parameter is set to `MENTIONS`, the number of reviews of items within the requested browse node that mention the topic determine 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 items within the requested browse node determine placement in the list. This value is `null` if there are not enough positive reviews for the requested browse node. **Max length:** 10 - `topic` string, required: The name browse node review topic. - `browseNodeMetrics` BrowseNodeReviewTopicMetrics, required: The browse node review topic metrics. - `occurrencePercentage` BrowseNodeAllOccurrence: The browse node review occurrence metrics. - `topTwentyFivePercentProducts` number, float, required: The percentage of reviews of the top 25 percent of products in the browse node that mention the topic. - `allProducts` number, float, required: The percentage of reviews of products in the browse node that mention the topic. - `starRatingImpact` BrowseNodeAllStarRatingImpact: The effects of a topic on the star ratings in a browse node. - `topTwentyFivePercentProducts` number, float, required: The effect of the topic on the star rating of the top 25 percent of products in the browse node. This value can be positive or negative. - `allProducts` number, float, required: The effect of the topic on the star rating of all products in the browse node. This value can be positive or negative. - `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` BrowseNodeSubtopic[]: A list of the five subtopics that occur most frequently. This value is `null` if there are no subtopics. - `subtopic` string, required: The name of the browse node review subtopic. - `metrics` BrowseNodeReviewSubtopicMetrics, required: The browse node review subtopic metrics. - `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 topic. This value is `null` if there aren't enough review snippets for the subtopic. - `negativeTopics` BrowseNodeReviewTopic[]: A list of the most negative review topics. When the `sortBy` query parameter is set to `MENTIONS`, the number of reviews of items within the requested browse node that mention the topic determine 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 items within the requested browse node determine placement in the list. This value is `null` if there are not enough negative reviews for the requested browse node. **Max length:** 10 - `topic` string, required: The name browse node review topic. - `browseNodeMetrics` BrowseNodeReviewTopicMetrics, required: The browse node review topic metrics. - `occurrencePercentage` BrowseNodeAllOccurrence: The browse node review occurrence metrics. - `topTwentyFivePercentProducts` number, float, required: The percentage of reviews of the top 25 percent of products in the browse node that mention the topic. - `allProducts` number, float, required: The percentage of reviews of products in the browse node that mention the topic. - `starRatingImpact` BrowseNodeAllStarRatingImpact: The effects of a topic on the star ratings in a browse node. - `topTwentyFivePercentProducts` number, float, required: The effect of the topic on the star rating of the top 25 percent of products in the browse node. This value can be positive or negative. - `allProducts` number, float, required: The effect of the topic on the star rating of all products in the browse node. This value can be positive or negative. - `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` BrowseNodeSubtopic[]: A list of the five subtopics that occur most frequently. This value is `null` if there are no subtopics. - `subtopic` string, required: The name of the browse node review subtopic. - `metrics` BrowseNodeReviewSubtopicMetrics, required: The browse node review subtopic metrics. - `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 topic. 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.dev/aws-samples/apis/a-content-management-v2020-11-01.md) - [All operations](https://skmtc.dev/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) - [OpenAPI document](https://skmtc.dev/aws-samples/apis/a-content-management-v2020-11-01/revisions/815a5b6dbaa6?raw)