All Collections
Data Sources
Amazon Advertising: Reporting API V2 to V3 Migration
Amazon Advertising: Reporting API V2 to V3 Migration

Migrate reporting from version 2 to version 3 of the API

Openbridge Support avatar
Written by Openbridge Support
Updated over a week ago

Amazon is releasing a new version of the reporting API for Sponsored Advertising (Brands, Products, Display, Video). However, the rollout is uneven; only Sponsored Products is available in the new API. As a result, this creates a situation where we have to leverage two different APIs for reports. Given the significant changes from v2 to v3, we have two connectors;

  1. Sponsored Brands & Sponsored Display on the v2 API

  2. Sponsored Products using the new v3 API.

While we highlight key changes between v2 and v3 below, given the significant changes for Sponsored Products reports between the legacy v2 and new v3 API reports, we suggest reviewing Amazon's migration guide and the Amazon Ads API Reporting API V3 FAQs.

Available Reports Version 3 Reporting API

Currently, the new API is limited in the available reports compared to V2. Only Sponsored Products is available in the new API. Per Amazon;

Version 3 reporting currently supports all Sponsored Products report types in version 2. For Sponsored Display and Sponsored Brands reports, you should continue to use version 2 while we add support to version 3.

Specifically, here is what is available in the new V3 API reporting;

Report type

Sponsored Products

Sponsored Brands







As you can see, the available reports are not paralleled with v2 (yet). This is why we have TWO connectors, one for Sponsored Brands & Display and another for Sponsored Products.

Changes to Metric Naming

In addition to changes in reports, the content of those reports is changing. There are changes to metric names from v2 to v3. Per Amazon, below are some of those changes for reference;

Version 2 metric name

Version 3 column name

New metrics


Did this answer your question?