Review insights
Learn what buyers praise and complain about — for your ASIN and for your whole category — and ask delivered orders for a review.
In short
Your agent reads Amazon's review topics and trends for an ASIN or a category, return reasons for the category, and can write a buyer-insights report. It can also send Amazon's review request to delivered orders.
In your daily workflow
What buyers say about your product
customerFeedback_getItemReviewTopics returns the top positive and negative topics for your ASIN; customerFeedback_getItemReviewTrends shows how they move month to month.
What buyers say about the category
customerFeedback_getItemBrowseNode finds the ASIN's category; customerFeedback_getBrowseNodeReviewTopics, customerFeedback_getBrowseNodeReturnTopics and their trend twins show what the whole category is praised for and returned for.
A report to work from
customerFeedback_insights_report writes a buyer-insights report to guide your copy and images; customerFeedback_insights_report_status tells you when it is ready. The report is paid from Credits — priced before it runs, refunded if it fails.
Ask for reviews
solicitations_getSolicitationActionsForOrder checks whether an order can be asked; solicitations_createProductReviewAndSellerFeedbackSolicitation sends Amazon's own review request.
Try asking
"What are the 10 things buyers praise and complain about most on this ASIN?"
"How have return reasons in this category trended over 6 months?"
"Send a review request to these delivered orders."
Step 1, both ways
The same tool and the same arguments — through your AI client, or from your own code.
MCP — you ask: "What are the top review complaints for B0EXAMPLE1?" Your agent calls customerFeedback_getItemReviewTopics and summarises them.
In an AI client (MCP)
{
"name": "customerFeedback_getItemReviewTopics",
"arguments": {
"store": "myStore-US",
"asin": "B0EXAMPLE1",
"sortBy": "MENTIONS"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/customerFeedback_getItemReviewTopics \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","asin":"B0EXAMPLE1","sortBy":"MENTIONS"}'Write access required
Sending review requests acts on your seller account, so the store needs write access (see Stay in control). Reading topics and trends works with read access.
Tools on this page
Pulled from the catalog at build time, each with its own access label.
| Tool | Access | What it does |
|---|---|---|
customerFeedback_getBrowseNodeReturnTopics | read | The top 10 reasons customers give when returning products in a browse node, each with its share of the category's returns (US, UK, FR, IT, DE, ES, JP only) — use them to set accura |
customerFeedback_getBrowseNodeReturnTrends | read | Month-by-month share of the category's returns that cite each return reason (past 6 months, newest first) for a browse node (US, UK, FR, IT, DE, ES, JP only) — whether a reason is |
customerFeedback_getBrowseNodeReviewTopics | read | The 10 most positive and 10 most negative review topics of a whole browse node (US, UK, FR, IT, DE, ES, JP only). |
customerFeedback_getBrowseNodeReviewTrends | read | Month-by-month occurrence trends (past 6 months, newest first) of a browse node's top review topics — the category baseline for customerFeedback_getItemReviewTrends (US, UK, FR, IT |
customerFeedback_getItemBrowseNode | read | Get the browse node (category) ID for a specific ASIN. |
customerFeedback_getItemReviewTopics | read | The 10 most positive and 10 most negative review topics of one ASIN (US, UK, FR, IT, DE, ES, JP only), each with review snippets, occurrence %, star-rating impact and the browse-no |
customerFeedback_getItemReviewTrends | read | Month-by-month occurrence trends (past 6 months, newest first) of one ASIN's 10 most positive and 10 most negative review topics, beside the category's — to see whether a fix impro |
customerFeedback_insights_report | write | Buyer insights report for ONE ASIN — what buyers of this CATEGORY praise, complain about and return, turned into the questions to answer before writing listing copy. |
customerFeedback_insights_report_status | read | Poll a Buyer insights job submitted by customerFeedback_insights_report — every ~4 s until status is done or error. |
solicitations_createProductReviewAndSellerFeedbackSolicitation | write | Send a product review and seller feedback solicitation for an order. |
solicitations_getSolicitationActionsForOrder | read | Check which solicitation actions are available for an order. |
FAQ
Can I turn the insights into new copy and images?
Yes — hand them to A+ Content or AI images.
Is there a skill for the report?
Yes — see Install the skills.