Adverso
Browse all topics

Available data

Which Amazon reports are behind the tools, how far back they go, and what the account structure covers.

Two kinds of data are stored: performance, which is one row per item per day, and structure, which is the account as it is now.

Performance

Daily reports from the Amazon Ads API. Each tool reads the report at its level.

DataToolSponsored ProductsSponsored BrandsSponsored Display
Campaignsget_campaignsyesyesyes
Ad groupsget_ad_groupsyesyesyes
Keywords and targetsget_keywordsyesyesyes
Search termsget_search_termsyesyesno
Placementsget_placementsyesyesno
Advertised productsget_productsyesnoyes
Adsget_adsnoyesno
Purchased productsget_purchased_productsyesyesyes
Matched targetsget_matched_targetsnonoyes
Invalid trafficget_invalid_trafficyesyesyes

Where the table says no, Amazon has no such report.

How far back

Amazon keeps each report for a limited time, so that is as far as a first download can reach:

Ad typeAmazon keeps
Sponsored Products95 days (search terms: 65 days)
Sponsored Brands60 days
Sponsored Display65 days

From the day a marketplace is on your plan, its days are kept, so the history grows past these limits over time. list_accounts always tells you the first and last day available for each marketplace.

Recent days change

Amazon revises its own figures after the fact. Clicks and impressions can change for about 3 days. Sales and orders are credited to the day of the click, so they keep arriving: Amazon restates them 1, 7 and 28 days later. The last few days of any period are therefore lower than they will end up.

Structure

get_structure returns the account as it was at the last download:

TypeSponsored ProductsSponsored BrandsSponsored Display
campaignyesyesyes
ad_groupyesyesyes
keywordyesyesno
targetyesyesyes
negativesad group and campaign levelad group levelad group level
product_adyesnoyes
adnoyesno
portfolioall ad types

Paused and archived items are included.

Product history

Amazon reports a product's best-seller rank only as it is today. Adverso records it once a day, together with price and availability, and get_product_history returns the days it has. The record starts on the day a marketplace is connected; earlier days cannot be recovered.

Every field

The tables above say which reports exist. All fields lists every field inside them, with its meaning.

Products

For every product that appears in the ads data, Adverso stores what the Amazon Ads API knows about it: title, main image, brand, category, best-seller rank, price, availability and whether it can be advertised. See product.

Not included yet

These are planned. Their tools are listed in Read and write.

  • Hourly data.
  • Total and organic sales per product, from Seller Central or Vendor Central.
  • Amazon's budget recommendations.

Not included

  • Amazon DSP.
  • Amazon Marketing Cloud.