There are three core Brand Analytics reports supported by Amazon for Sellers and Vendors;
GET_BRAND_ANALYTICS_MARKET_BASKET_REPORT
GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT
GET_BRAND_ANALYTICS_REPEAT_PURCHASE_REPORT
Brand Analytics is only available to Sellers and Vendors registered in Amazon's Brand Registry. If you are unclear about what this means or the exact permissions Amazon requires, see our troubleshooting doc for more information.
Data Outputs
The outputs from the API are aligned by DAY, WEEK, MONTH, and QUARTER. As a result, there are 6 daily data outputs for each based on periods;
sp_ba_market_basket
sp_ba_repeat_purchase
sp_ba_search_terms_by_day
sp_ba_search_terms_by_month
sp_ba_search_terms_by_quarter
sp_ba_search_terms_by_week
Since the data is unified in each date output, you will need to use various columns to filter outputs. For example, in search terms, use department
column to select the appropriate value. If you wanted to look at only Amazon.com
, then you would use that in your query to filter the results.
Lookback Schedules
Due to the latency of changes at Amazon, as previously described, we use a LOOKBACK schedule for Brand Analytics of 1, 3, 7, and 30 days from the current date.
A lookback will also care for requests in cases where Amazon systems are unavailable. For example, Amazon says the "Daily Amazon Search Terms data processing is delayed. We are aware of the issue and actively working to resolve this delay. The dashboard will be refreshed with the latest data as soon as it is available." Openbridge will attempt to re-request a given date multiple times in these cases. For example, if search data is delayed on June 1, we will attempt to request the June 1 data on June 2, June 3rd, June 8th, and July 1.
As a result, any back updates Amazon may have made to older data would be updated. While we request older data, it may be possible that there is no new data to load for a given date.
See De-duplication and dealing with updates over a long time horizon for guidance on how to query this data.
Brand Analytics leverage the Amazon Reporting API for the report types listed above. For more details on the above report types, see Amazon's docs.
Understanding Search Terms: Data Category (Department) and Date Ranges
The data reflects 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.
The search term data is expansive and is organized by 51 departments. Those departments have 4 date dimensions; daily, weekly, monthly, and quarterly. Here are Amazon search terms example departments available for download;
Amazon.com
APS
AWS-APS
Alexa Skills
Amazon Custom
AmazonBasics
Arts, Crafts, and Sewing
Automotive
Baby
Beauty
Books
Camera and Photo
Collectibles
Computers
Courses
Credit Cards
Electronics
Fresh
Gift Cards
Gourmet
Grocery
HPC
Handmade
Home Improvement
Home and Garden
Industrial and Scientific
Kindle Store
Launchpad
Local Services
MP3 Downloads
Magazines and Newspapers
Merchants
Mobile Apps Store
Movies and TV
Music
Musical Instruments
Office Products
Prime Pantry
RPS
Retail Help
Softlines
Software
Sports and Outdoors
Toys
Uncategorized
Vehicles
Video Games
Video On Demand
Video Shorts
Warehouse Deals
Wireless
These departments may change over time as Amazon adjusts product offerings. The outputs from the API are dynamic, meaning whatever Amazon supplies, we will include them.