Analytics Reports

Market Basket Analysis Report

reportType value:
GET_BRAND_ANALYTICS_MARKET_BASKET_REPORT

Schemas: sellingPartnerMarketBasketAnalysisReport

Available to sellers and vendors who have the Brand Analytics Selling Partner API role and who are registered in Amazon's Brand Registry.

JSON report containing data on the items that are most commonly purchased in combination with the items in the customer's basket (cart) at checkout. The data is available across different reporting periods: DAY, WEEK, MONTH, and QUARTER. Requests can span multiple reporting periods. In this report, an asin property is an ASIN in the selling partner's catalog and a purchasedWithAsin property might or might not be an ASIN in the selling partner's catalog.

This report accepts the following reportOptions value:

• reportPeriod. Specifies the reporting period for the report. Values include DAY, WEEK, MONTH, and QUARTER
  Example:
  "reportOptions":{"reportPeriod": "WEEK"}

Requests must include the reportPeriod in the reportsOptions. Use the dataStartTime and dataEndTime parameters to specify the date boundaries for the report. The dataStartTime and dataEndTime values must correspond to valid first and last days in the specified reportPeriod. For example, dataStartTime must be a Sunday and dataEndTime must be a Saturday when reportPeriod=WEEK .

Can be requested.

Repeat Purchase

reportType value:
GET_BRAND_ANALYTICS_REPEAT_PURCHASE_REPORT

Schemas: sellingPartnerRepeatPurchaseReport

Available to sellers and vendors who have the Brand Analytics Selling Partner API role and who are registered in Amazon's Brand Registry.

JSON report containing data on the quantity of repeated purchases of the selling partner's items. The data is available across different reporting periods: WEEK, MONTH, and QUARTER. Requests can span multiple reporting periods. In this report, an asin property is an ASIN in the selling partner's catalog.

This report accepts the following reportOptions value:

• reportPeriod. Specifies the reporting period for the report. Values include WEEK, MONTH, and QUARTER
  Example:
  "reportOptions":{"reportPeriod": "WEEK"}

Requests must include the reportPeriod in the reportsOptions. Use the dataStartTime and dataEndTime parameters to specify the date boundaries for the report. The dataStartTime and dataEndTime values must correspond to valid first and last days in the specified reportPeriod. For example, dataStartTime must be a Sunday and dataEndTime must be the following Saturday when reportPeriod=WEEK.

Can be requested.

Vendor Sales Report

reportType value:
GET_VENDOR_SALES_REPORT

Schemas: vendorSalesReport/a>

Available to vendors who have the Brand Analytics Selling Partner API role.

JSON report with key retail sales metrics such as ordered/shipped revenue and units. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across DAY, WEEK, MONTH, QUARTER, and YEAR reporting periods.

This report accepts the following reportOptions values:

• reportPeriod. Specifies the reporting period for the report. Values include DAY, WEEK, MONTH, QUARTER and YEAR.
  Example:
  "reportOptions":{"reportPeriod": "WEEK"}
• distributorView. Specifies the distributor view requested. Values include MANUFACTURING and SOURCING.
  Example:
  "reportOptions":{"distributorView": "SOURCING"}
• sellingProgram. Specifies the selling program for the report. Values include RETAIL, BUSINESS, and FRESH.
  Example:
  "reportOptions":{"sellingProgram": "RETAIL"}

Requests must include the reportPeriod, distributorView, and sellingProgram properties. Use the dataStartTime and dataEndTime parameters to specify the date boundaries for the report. The dataStartTime and dataEndTime values must correspond to valid first and last days in the specified reportPeriod. For example, dataStartTime must be a Sunday and dataEndTime must be a Saturday when reportPeriod=WEEK .

Maximum lookback windows

Here are the maximum lookback windows (from the current date) that are available for each reportPeriod type. Specify a dataStartTime parameter that falls within the maximum lookback window for the reporting period that you want:

• DAY. 1,460 days
• WEEK. 7 weeks
• MONTH. 36 months
• QUARTER. 8 quarters
• YEAR. 3 years

Maximum reporting periods

Here are the maximum reporting periods that you can specify using the dataStartTime and dataEndTime parameters, by reportPeriod type:

• DAY. 15 days
• WEEK. 7 weeks
• MONTH. 15 months
• QUARTER. 4 quarters
• YEAR. 2 years

Data availability

The SLA for weekly reporting periods (i.e. Saturday datasets) is the end of the day Monday, 48 hours after the close of the period. The SLA for non-Saturday daily reporting periods is 72 hours after the close of the period. If you request a report for a reporting period that is not yet available, the report will not be generated and processingStatus for the report will be FATAL. You can get the processing status of the report by polling the getReport operation of the Reports API. For more information, see the Reports API Use Case Guide.

Can be requested.

Vendor Traffic Report

reportType value:
GET_VENDOR_TRAFFIC_REPORT

Schemas: vendorTrafficReport

Available to vendors who have the Brand Analytics Selling Partner API role.

JSON report with key retail traffic metrics such as detail page views (i.e. glance views). Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across DAY, WEEK, MONTH, QUARTER, and YEAR reporting periods.

This report accepts the following reportOptions value:

• reportPeriod. Specifies the reporting period for the report. Values include DAY, WEEK, MONTH, QUARTER and YEAR.
  Example:
  "reportOptions":{"reportPeriod": "WEEK"}

Requests must include the reportPeriod property. Use the dataStartTime and dataEndTime parameters to specify the date boundaries for the report. The dataStartTime and dataEndTime values must correspond to valid first and last days in the specified reportPeriod. For example, dataStartTime must be a Sunday and dataEndTime must be a Saturday when reportPeriod=WEEK .

Maximum lookback windows

Here are the maximum lookback windows (from the current date) that are available for each reportPeriod type. Specify a dataStartTime parameter that falls within the maximum lookback window for the reporting period that you want:

• DAY. 1,460 days
• WEEK. 7 weeks
• MONTH. 36 months
• QUARTER. 8 quarters
• YEAR. 3 years

Maximum reporting periods

Here are the maximum reporting periods that you can specify using the dataStartTime and dataEndTime parameters, by reportPeriod type:

• DAY. 15 days
• WEEK. 7 weeks
• MONTH. 15 months
• QUARTER. 4 quarters
• YEAR. 2 years

Data availability

The SLA for the weekly reporting periods (i.e. Saturday datasets) is the end of the day Monday, 48 hours after the close of the period. The SLA for non-Saturday daily reporting periods is 72 hours after the close of the period. If you request a report for a reporting period that is not yet available, the report will not be generated and processingStatus for the report will be FATAL. You can get the processing status of the report by polling the getReport operation of the Reports API. For more information, see the Reports API Use Case Guide.

Can be requested.

Sales and Traffic Business Report

reportType value: GET_SALES_AND_TRAFFIC_REPORT

Schemas: sellerSalesAndTrafficReport

Available to sellers who have the Brand Analytics Selling Partner API role.

JSON report with key sales performance metrics such as ordered product sales, revenue, units ordered, and claim amount, as well as page traffic metrics such as page views and buy box percentage of the seller’s entire catalog of items aggregated by date and ASIN.

Note: The dataStartTime value provided when requesting this report must not be more than two years before the date of the request. Failing this condition will result in the request being cancelled.

This report accepts the following reportOptions values:

• dateGranularity - Data is available at different date range aggregation levels: DAY, WEEK, MONTH. Default: DAY.
• asinGranularity - Data is available at different ASIN aggregation levels: PARENT, CHILD, SKU. Default: PARENT.

Example:
"reportOptions":{"dateGranularity":"MONTH", "asinGranularity":"CHILD"}

When dateGranularity is WEEK or MONTH the dataStartTime and dataEndTime values are expanded to that level of granularity. For WEEK the beginning is Sunday and the end is Saturday, and for MONTH the beginning is the first day of the month and the end is the last day of the month.

For example, if the dateGranularity value is WEEK and the provided dataStartTime value is on a Tuesday, that dataStartTime value will automatically be changed to the Sunday before that Tuesday. Likewise, if a dataStartTime value of 3/16/2021 and a dataEndTime of 4/16/2021 are provided with a dateGranularity of MONTH, the dataStartTime will become 3/1/2021 and the dataEndTime will become 4/30/2021.

If the expanded dataStartTime value is more than two years before the date of the request, then it will be corrected to be within two years of the request date provided the original dataStartTime is with two years of the request date. If the expanded dataEndTime value is in the future, then the report will contain partial data for the most recent report period.

Can be requested or scheduled.