For the complete documentation index, see llms.txt. This page is also available as Markdown.

Review Insights

Read what customers praise and complain about, from Amazon review topics.

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 and USPs 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 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 standouttrue when the ASIN mentions the topic far more than the category average.

    • Review snippets — a few representative quotes.

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.

Review data is only available for child ASINs in marketplaces with Amazon's customer-feedback feed. Parent ASINs and other marketplaces return no topics.

Last updated