---
title: "getItemReviewTrends"
method: GET
path: "/customerFeedback/2024-06-01/items/{asin}/reviews/trends"
tags: ["Customer Feedback v2024-06-01"]
---

# getItemReviewTrends

`GET /customerFeedback/2024-06-01/items/{asin}/reviews/trends`

## Request

- Base URL: `https://sellingpartnerapi-na.amazon.com`
- URL: `https://sellingpartnerapi-na.amazon.com/customerFeedback/2024-06-01/items/{asin}/reviews/trends`
- Auth: none declared

Retrieve an item's positive and negative review trends for the past six months.

## Path parameters

- `asin` string, required

## Query parameters

- `marketplaceId` string, required

## Response `200`

Success.

- ItemReviewTrendsResponse: The response for the `getItemReviewTrends` 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.
  - `reviewTrends` ItemReviewTrends, required: The 10 most positive and most negative review topics for all items in a browse node.
    - `positiveTopics` ItemReviewTrend[]: A list of the most positive review topics. The percentage of reviews that contain the topic determines the topic's 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.
      - `trendMetrics` ItemReviewTrendPoint[], required: The item's review trend metrics for the past six months.
        - `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.
        - `asinMetrics` ReviewTrendMetrics, required: The item review trend metrics.
          - `occurrencePercentage` number, float, required: The percentage of reviews that mention the topic.
        - `parentAsinMetrics` ReviewTrendMetrics: The item review trend metrics.
          - `occurrencePercentage` number, float, required: The percentage of reviews that mention the topic.
        - `browseNodeMetrics` BrowseNodeTrendMetrics: A single browse node review or return trend metric.
          - `occurrencePercentage` BrowseNodeOccurrence, required: 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.
    - `negativeTopics` ItemReviewTrend[]: A list of the most negative review topics. The percentage of reviews that contain the topic determines the topic's 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.
      - `trendMetrics` ItemReviewTrendPoint[], required: The item's review trend metrics for the past six months.
        - `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.
        - `asinMetrics` ReviewTrendMetrics, required: The item review trend metrics.
          - `occurrencePercentage` number, float, required: The percentage of reviews that mention the topic.
        - `parentAsinMetrics` ReviewTrendMetrics: The item review trend metrics.
          - `occurrencePercentage` number, float, required: The percentage of reviews that mention the topic.
        - `browseNodeMetrics` BrowseNodeTrendMetrics: A single browse node review or return trend metric.
          - `occurrencePercentage` BrowseNodeOccurrence, required: 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.

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