Optimize listings
Improve titles, bullets, images and A+ content with your own agent — grounded in your reviews, your competitors and Amazon's own data.
In short
Optimizing a listing is several reads and a few careful writes: what buyers say, what competitors show, what Amazon has on file, then new copy and images you approve before anything is submitted.
Step by step
Learn what buyers say
customerFeedback_getItemReviewTopics lists the topics buyers praise and complain about most on your ASIN — the raw material for better bullets. See Review insights.
See what competitors show
catalogItems_searchCatalogItems and catalogItems_getCatalogItem pull competitors' titles, bullets and images; productPricing_getCompetitiveSummary shows where your price sits.
Start from what is live
listings_fetch_attributes_by_asins puts your current title, bullets and attributes side by side in a sheet, so every change is visible as an edit.
Rewrite, review, submit
Your agent drafts new copy in the sheet for you to edit; new images come from AI image generation and A+ from the A+ workflow. When you approve, listings_patchListingsItem updates just the attributes you changed.
Try asking
"Optimize the listing for ASIN B0EXAMPLE1 — start from its reviews and its three closest competitors, and put the proposed title and bullets next to the current ones in a sheet."
A listing-optimization skill that runs this end to end — reviews, competitors, keywords, images, A+ and a PPC plan — is on the way to the skills catalog.
The review read, both ways
The same tool and the same arguments — through your AI client, or from your own code.
MCP — you ask: "What do buyers complain about most on B0EXAMPLE1?" Your agent calls customerFeedback_getItemReviewTopics and turns the topics into copy ideas.
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
Patching a listing changes your seller account, so the store needs write access (see Stay in control). Every read on this page 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_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 |
catalogItems_searchCatalogItems | read | Search Amazon's live catalog by keywords or by identifiers — what shoppers see, not one seller's submission. |
catalogItems_getCatalogItem | read | Get Amazon's LIVE catalog data for a single ASIN — the reconciled version that shoppers see on the detail page. |
productPricing_getCompetitiveSummary | read | Competitive summary for 1–20 ASINs (Product Pricing v2022-05-01): featured buying options (who wins the featured offer, at what price), lowest-priced offers, reference prices and s |
listings_fetch_attributes_by_asins | read | Bulk fetch + flatten Amazon catalog attributes for N ASINs in ONE call. |
listings_patchListingsItem | destructive | Patch attributes on an existing listing (JSON Patch) without replacing it — the tool for fixing a suppressed listing or changing price, inventory, title or images. |
FAQ
Does copy or image generation use Credits?
Images and buyer-insights reports use Credits; see Credits & limits.
Can I change many listings at once?
Yes — through a Publish Queue sheet. See Attributes & Publish Queue.