> For the complete documentation index, see [llms.txt](https://docs.autopilotbrand.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autopilotbrand.com/autopilot-mcp/tools/get-asin-review-insights.md).

# Review Insights

`get_asin_review_insights`

Returns Amazon customer review topics for an ASIN, split into positive and negative sentiment and sorted by how often each is mentioned. Each topic shows how much it moves the product's star rating, how commonly it comes up, whether it stands out against the category, and a few representative review snippets. It's the tool behind any question about what customers love or dislike about a product.

## When it's used

Use it to understand the voice of the customer for a product: the top praises and complaints, which themes weigh most on the star rating, and where the product beats or trails its category. It pairs well with [Facts](/autopilot-mcp/tools/list-asin-facts.md) and [USPs](/autopilot-mcp/tools/list-asin-usps.md) to connect customer sentiment back to the selling points and content.

## What you can ask

> *"What do customers praise and complain about for B07XYZ1234 in the US?"*

> *"Which negative review topics hurt this ASIN's star rating the most?"*

> *"What did reviews look like for this product as of the end of last quarter?"*

## Parameters

| Parameter        | Required | Description                                                                                 |
| ---------------- | -------- | ------------------------------------------------------------------------------------------- |
| `asin`           | Yes      | The 10-character ASIN.                                                                      |
| `marketplace_id` | Yes      | Which marketplace (see the [Tools page](/autopilot-mcp/tools.md#identifiers) for IDs).      |
| `date`           | No       | Returns the most recent review snapshot recorded on or before this date. Defaults to today. |

## What you get back

* **`data_as_of`** — the date of the snapshot the response reflects.
* **Positive topics** and **negative topics**, each sorted by mention count. Every topic includes:
  * **Topic** — the theme customers are talking about.
  * **Mentions count** — how many reviews raise it.
  * **Star-rating impact** — how much the topic moves the ASIN's rating.
  * **Occurrence percentage** — how commonly it comes up in reviews.
  * **Category standout** — `true` when the ASIN mentions the topic far more than the category average.
  * **Review snippets** — a few representative quotes.

{% hint style="info" %}
Review insights are a periodic **snapshot**, not a live feed. Use `data_as_of` to see which snapshot you're looking at, and the `date` parameter to look back at an earlier one.
{% endhint %}

{% hint style="info" %}
Review data is only available for **child ASINs** in marketplaces with Amazon's customer-feedback feed. Parent ASINs and other marketplaces return no topics.
{% endhint %}
