---
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`

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.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)
