Overview

Amazon has upgraded the Data Kiosk API’s Vendor Analytics dataset, adding two customer‑feedback metrics and a vendor‑code grouping field. The new metrics deliver structured sentiment and return‑reason data at both product and category levels, while the grouping attribute lets multi‑account vendors slice performance by operational unit. All changes are live across every Amazon marketplace, giving sellers immediate access to richer insights.

Key Points

• customerReviewsTopics metric — Returns the most frequent positive and negative review themes together with the star‑rating impact for each ASIN and for entire browse nodes.
• customerReturnTopics metric — Supplies aggregated return‑reason statistics at the browse‑node level, highlighting category‑wide patterns that individual ASIN reports often miss.
• vendorCode group‑by attribute — Enables API queries to segment results by vendor code, allowing direct comparison of separate business units or regional accounts.
• Global rollout — The new fields are available on every Amazon marketplace, from the United States to Japan, without the need for regional enablement.
• Mandatory ASIN grouping — Queries that request the feedback metrics must include asin in the groupBy clause, otherwise the API returns an error.
• Non‑additive time windows — Feedback metrics do not sum across date ranges, so standard period filters behave differently than for sales or traffic data.

How the New Metrics Work

1. Requesting review topics — Include customerReviewsTopics in the metrics array and set groupBy to asin (or both asin and browseNode). The response lists top positive and negative themes, each paired with a “rating impact” score that quantifies how much the theme shifts the average star rating.
   Example: A query for ASIN B07XYZ returns “packaging damage” as a negative theme with a –0.42 impact, indicating that this complaint drags the product’s rating down by roughly four‑tenths of a star.