Analytics Reports
Analytics Reports for the Selling Partner Reports API.
Brand Analytics reports
Market Basket Analysis Report
reportType
value: GET_BRAND_ANALYTICS_MARKET_BASKET_REPORT
Schema: sellingPartnerMarketBasketAnalysisReport
Role: Brand Analytics
Availability: Sellers and vendors who have the Brand Analytics Selling Partner API role and are registered in Amazon Brand Registry.
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains 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.
Select to expand list of report attributes.
dataByAsin
startDate
endDate
asin
purchasedWithAsin
purchasedWithRank
combinationPct
Amazon Search Terms Report
reportType
value: GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT
Schema: sellingPartnerSearchTermsReport
Role: Brand Analytics
Availability: Sellers and vendors who have the Brand Analytics Selling Partner API role and are registered in Amazon Brand Registry.
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains data on the top clicked ASINs by search keyword and department for a marketplace. The data is available across different reporting periods: DAY, WEEK, MONTH, and QUARTER. Requests cannot span multiple reporting periods. For example, a request with "reportPeriod": "WEEK"
could not start on 2021-06-06 and end on 2021-06-19, as this would span more than one week.
This report is limited in size to approximately 12 million items, which are lists of top ASINs categorized by search term and department. This limit may cause this report to differ from other reporting, such as Amazon Retail Analytics.
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 "reportOptions":{"reportPeriod": "WEEK"}
.
Select to expand list of report attributes.
searchTerm
searchFrequencyRank
clickedAsin
clickShareRank
clickShare
conversionShare
Repeat Purchase
reportType
value: GET_BRAND_ANALYTICS_REPEAT_PURCHASE_REPORT
Schema: sellingPartnerRepeatPurchaseReport
Role: Brand Analytics
Availability: Sellers and vendors who have the Brand Analytics Selling Partner API role and are registered in Amazon Brand Registry.
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains 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 a Saturday when reportPeriod
=WEEK.
Select to expand list of report attributes.
startDate
endDate
asin
orders
uniqueCustomers
repeatCustomersPctTotal
repeatPurchaseRevenue
repeatPurchaseRevenuePctTotal
Vendor retail analytics reports
Rapid Retail Analytics Inventory Report
reportType
value: GET_VENDOR_REAL_TIME_INVENTORY_REPORT
Schema: vendorRealTimeInventoryReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains inventory data at an ASIN level, aggregated to an hourly granularity. Requests can span multiple date range periods, including the current day.
ASINs are included if the number of units available for purchase by customers has changed. In addition to orders and cancellations, other activities which could impact the number of units available for purchase include add-to-cart actions, processed Subscribe-and-Save orders, and new quantities being made available.
The lowest granularity of rapid retail analytics is hourly. Reports can be requested minutes after the close of an hour, with specific thresholds based on the dataset. For inventory, information can be requested five minutes after the close of each hour. For example, you can request 8:00 AM - 9:00 AM at 9:05 AM.
Rapid retail analytics represents cancellations based on the time of the cancellation.
The lookback window for this report is 30 days and the maximum date span is 7 days. For example, if you wanted to query February 2024, you would request four report date ranges:
- Feb 1 - Feb 7
- Feb 8 - Feb 14
- Feb 15 - Feb 21
- Feb 22 - Feb 28
Available to sellers and vendors as the ITEM_INVENTORY_EVENT_CHANGE
notification.
Select to expand list of report attributes.
reportSpecification
reportData
reportType
dataStartTime
dataEndTime
marketplaceIds
startTime
endTime
asin
highlyAvailableInventory
Rapid Retail Analytics Traffic Report
reportType
Value: GET_VENDOR_REAL_TIME_TRAFFIC_REPORT
Schema: vendorRealTimeTrafficReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains data on the customer traffic to the detail pages of the vendor's items with an hourly granularity. Requests can span multiple date range periods. For example, if the customer specified that dataStartTime
and dataEndTime
span three hours, the report would contain data for each complete hour within the time span.
The report payload includes ASINs whose product detail page received glance views during that period where a given merchant is the featured offer, including when multiple offers for the same merchant are shown (for example, Subscribe and Save, used products, buy on Fresh).
The lowest granularity of rapid retail analytics is hourly. Traffic data is available approximately 65 to 115 minutes after the close of an hour. For example, you can request 8:00 AM – 9:00 AM traffic data at 10:05 AM.
The lookback window for this report is 30 days and the maximum date span is 14 days. For example, if you wanted to query February 2024 you would request two report date ranges:
- Feb 1 - Feb 14
- Feb 15 - Feb 28
Available to sellers and vendors as the DETAIL_PAGE_TRAFFIC_EVENT
notification.
Select to expand list of report attributes.
reportSpecification
reportData
reportType
dataStartTime
dataEndTime
marketplaceIds
startTime
endTime
asin
glanceViews
Rapid Retail Analytics Sales Report
reportType
Value: GET_VENDOR_REAL_TIME_SALES_REPORT
Schema: vendorRealTimeSalesReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains sales data at an ASIN level, aggregated to an hourly granularity. Requests can span multiple date range periods. For example, if the customer specified that dataStartTime
and dataEndTime
span three hours, the report would contain data for each complete hour within the time span.
ASINs are included when they have orders or cancellations during a given hour.
The lowest granularity of rapid retail analytics is hourly. Reports can be requested five minutes after the close of each hour. For example, you can request 8:00 AM - 9:00 AM at 9:05 AM.
Rapid retail analytics represents cancellations based on the time of the cancellation. To represent cancellations, ordered units may be negative for a given hour and ASIN combination.
The lookback window for this report is 30 days and the maximum date span is 14 days. For example, if you wanted to query February 2024 you would request two report date ranges:
- Feb 1 - Feb 14
- Feb 15 - Feb 28
Available to sellers and vendors as the ITEM_SALES_EVENT_CHANGE
notification.
Select to expand list of report attributes.
reportSpecification
reportData
reportType
dataStartTime
dataEndTime
marketplaceIds
reportOptions
startTime
endTime
asin
orderedUnits
orderedRevenue
Vendor Sales Report
reportType
Value: GET_VENDOR_SALES_REPORT
Schema: vendorSalesReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains 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
value:
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 includeMANUFACTURING
andSOURCING
. Example:"reportOptions":{"distributorView": "SOURCING"}
sellingProgram
- Specifies the selling program for the report. Values includeRETAIL
,BUSINESS
, andFRESH
. 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
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
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 Service Level Agreement (SLA) for weekly reporting periods (for example, 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, refer to the Reports API Use Case Guide.
Select to expand list of report attributes.
salesAggregate
salesByAsin
startDate
endDate
shippedCogs
shippedRevenue
shippedUnits
Net Pure Product Margin Report
reportType
Value: GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT
Schema: vendorNetPureProductMarginReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains data on Amazon's net pure product margins for selling a vendor's items. 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
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
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 (for example, 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.
Select to expand list of report attributes.
netPureProductMarginAggregate
netPureProductMarginByAsin
marketplaceIds
startDate
endDate
asin
netPureProductMargin
Vendor Traffic Report
reportType
Value: GET_VENDOR_TRAFFIC_REPORT
Schema: vendorTrafficReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains key retail traffic metrics such as detail page views (for example, 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
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
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 (for example, 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.
Select to expand list of report attributes.
trafficAggregate
trafficByAsin
startDate
endDate
asin
glanceViews
Vendor Forecasting Report
reportType
Value: GET_VENDOR_FORECASTING_REPORT
Schema: vendorForecastingReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains forward looking mean, Prior 70, Prior 80, and Prior 90 weekly customer demand forecasts. Data is reported at the ASIN level for the most recent weekly forecast generation date.
Note:
Only the most recent forecast data is available. Historical forecast data cannot be requested.
Note:
The forecasting system produces forecasts for an ASIN at various P-levels, also known as confidence levels. If you are setting a forecasting P-level of .80 (P80), it means that there is an 80% probability customer demand will not exceed the weekly forecasted units.
This report accepts the following reportOptions
value:
sellingProgram
- Specifies the selling program for the report. Values includeRETAIL
andFRESH
. Example:"reportOptions":{"sellingProgram": "RETAIL"}
Data availability
Refreshed forecasting data is available 72 hours after the week end (for example, end of the day Tuesday).
Select to expand list of report attributes.
forecastByAsin
forecastGenerationDate
asin
startDate
endDate
meanForecastUnits
p70ForecastUnits
p80ForecastUnits
p90ForecastUnits
Vendor Inventory Report
reportType
Value: GET_VENDOR_INVENTORY_REPORT
Schema: vendorInventoryReport
Role: Brand Analytics
Availability: Vendors
Requested/scheduled: This report can only be requested.
Report output type: JSON
Contains inventory and operational health metrics such as sellable on hand units and vendor confirmation rate.
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 includeMANUFACTURING
andSOURCING
. Example:"reportOptions":{"distributorView": "SOURCING"}
sellingProgram
- Specifies the selling program for the report. Values includeRETAIL
andFRESH
. Example:"reportOptions":{"sellingProgram": "RETAIL"}
Requests must include reportPeriod
, distributorView
, and sellingProgram
in 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.
Maximum lookback windows
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
- WEEK: 7 weeks
- MONTH: 36 months
- QUARTER: 8 quarters
- YEAR: 3 years
Maximum reporting periods
The maximum reporting periods that you can specify using the dataStartTime
and dataEndTime
parameters, by reportPeriod
type:
- DAY: 15
- WEEK: 7 weeks
- MONTH: 15 months
- QUARTER: 4 quarters
- YEAR: 2 years
Data availability
Refreshed data is available 72 hours after the close of the period. For example, weekly data (Sunday through Saturday dataset) is available by the end of the day Tuesday.
Select to expand list of report attributes.
reportSpecification
inventoryAggregate
inventoryByAsin
startDate
endDate
netReceivedInventoryCost
netReceivedInventoryUnits
openPurchaseOrderUnits
sellableOnHandInventoryCost
sellableOnHandInventoryUnits
Seller retail analytics reports
Sales and Traffic Business Report
reportType
Value: GET_SALES_AND_TRAFFIC_REPORT
Schema: sellerSalesAndTrafficReport
Role: Brand Analytics
Availability: Sellers
Requested/scheduled: This report can be requested or scheduled.
Report output type: JSON
Contains 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. If you fail this condition, the request will be 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.
Select to expand list of report attributes.
reportSpecification
salesAndTrafficByDate
salesAndTrafficByAsin
date
salesByDate
trafficByDate
orderedProductSales
orderedProductSalesB2B
unitsOrdered
unitsOrderedB2B
totalOrderItems
totalOrderItemsB2B
averageSalesPerOrderItem
averageSalesPerOrderItemB2B
averageUnitsPerOrderItem
averageUnitsPerOrderItemB2B
averageSellingPrice
averageSellingPriceB2B
unitsRefunded
refundRate
claimsGranted
claimsAmount
shippedProductSales
unitsShipped
ordersShipped
browserPageViews
browserPageViewsB2B
mobileAppPageViews
mobileAppPageViewsB2B
pageViews
pageViewsB2B
browserSessions
browserSessionsB2B
mobileAppSessions
mobileAppSessionsB2B
sessions
sessionsB2B
buyBoxPercentage
buyBoxPercentageB2B
orderItemSessionPercentage
orderItemSessionPercentageB2B
unitSessionPercentage
unitSessionPercentageB2B
averageOfferCount
averageParentItems
feedbackReceived
negativeFeedbackReceived
receivedNegativeFeedbackRate
parentAsin
salesByAsin
trafficByAsin
browserSessionPercentage
mobileAppSessionPercentage
sessionPercentage
browserPageViewsPercentage
mobileAppPageViewsPercentage
pageViewsPercentage
Updated 1 day ago