Update: Data Kiosk API Vendor Analytics dataset now supports new metrics
In early May 2026 Amazon expanded the Data Kiosk Vendor Analytics API with three cost metrics (shippedCogs, contraCOGS, contraCOGSPerUnit) and three attribute fields (zipCode, binding, color). The added columns increase payload size by roughly 15%, so pagination may need to be reduced (e.g., pageSize from 10,000 to 8,000).
Overview
In early May 2026 Amazon rolled out an upgrade to the Data Kiosk API’s Vendor Analytics dataset, adding three cost‑oriented metrics and three product‑attribute fields. The new data points give vendors finer‑grained insight into unit‑level expenses, buyer geography, and item characteristics, which can directly affect pricing, inventory, and marketing strategies.
Key Points
- Cost metrics introduced — The dataset now includes shippedCogs (total cost of goods that have left a fulfillment center), contraCOGS (cost adjustments such as refunds or promotions), and contraCOGSPerUnit (the per‑unit value of those adjustments).
- Attribute enrichment — Each order line also returns zipCode (buyer’s postal code), binding (e.g., paperback, hardcover), and color (e.g., red, blue), enabling more detailed segmentation.
- Payload growth of roughly 15 % — Adding six columns expands every record, so vendors should expect larger JSON responses and may need to revise pagination or storage limits.
- Optional fields preserve compatibility — Existing calls continue to work unchanged; the new columns appear only when requested, so legacy integrations remain functional.
- Near‑real‑time cost granularity — With contraCOGSPerUnit available, sellers can assess the financial impact of a single returned or discounted unit almost instantly.
- Geographic analysis capability — The zipCode attribute allows mapping of sales and cost data to specific neighborhoods, supporting localized promotions and smarter inventory placement.
How the Updated Data Kiosk API Works
-
Call the Vendor Analytics endpoint — Issue a GET request to
/vendor/analyticsand include the optionalincludeMetricsparameter to pull the new fields.- Example:
GET https://api.amazon.com/vendor/analytics?includeMetrics=shippedCogs,contraCOGS,contraCOGSPerUnit,zipCode,binding,colorreturns the full suite of added metrics together with the standard columns.
- Example:
Analysis & Recommendations
Why This Matters
Vendors can now separate shipped costs from adjustments and segment sales by buyer zip code, binding, and color, enabling more precise pricing, inventory placement, and marketing. However, the 15% larger responses may cause throttling or storage issues unless pagination and batch sizes are adjusted.
Key Takeaways
- Three new cost metrics—shippedCogs, contraCOGS, contraCOGSPerUnit—are now available in the Vendor Analytics dataset.
- Three new product‑attribute fields—zipCode, binding, color—can be requested via the includeMetrics parameter.
- Payload size grows ~15%, prompting a recommended pageSize reduction from 10,000 to 8,000 records per request.
- The new fields are optional and appear only when includeMetrics=shippedCogs,contraCOGS,contraCOGSPerUnit,zipCode,binding,color is used.
Recommended Actions
- →Update API calls in Seller Central > Integration > SP‑API settings to add includeMetrics=shippedCogs,contraCOGS,contraCOGSPerUnit,zipCode,binding,c...
- →Modify your ETL or data‑ingestion scripts (e.g., AWS Glue, Snowflake loaders) to lower pageSize to 8,000 or less to avoid payload‑too‑large errors.
- →Add the new fields to BI dashboards (e.g., Looker, QuickSight) by editing the data source schema and creating visualizations for shippedCogs and co...
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!