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

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