This is the complete list. Nothing is held back: each row carries every figure Amazon reports for it, and your AI decides what to show.
Field names inside more and details are Amazon's own, so they match the Amazon Ads documentation and exports you already know. The other names are Adverso's and are the same for every ad type.
Accounts
Returned by list_accounts
One entry per marketplace on your plan.
| Field | Meaning | Where |
|---|---|---|
| marketplace_id | The id to pass as marketplace_id to every other tool. | all |
| account | The account's name on Amazon. | all |
| account_type | seller or vendor. It decides the attribution window of Sponsored Products figures. | all |
| country | Country code as Amazon writes it, for example DE or UK. | all |
| store | The storefront, for example Amazon.de. | all |
| currency | The currency of the marketplace's money figures. | all |
| access | read or read_write, as set in the dashboard. | all |
| performance_data_from | The first day with performance data. | all |
| performance_data_to | The last day with performance data. | all |
| structure_updated_at | When the account structure was last downloaded. | all |
Overview
Returned by get_account_overview
Three views of the same period: total, by_ad_type (one entry for SP, SB and SD) and by_day.
| Field | Meaning | Where |
|---|---|---|
| impressions | Times an ad was shown. | all |
| clicks | Clicks on ads. | all |
| cost | Ad spend. | all |
| orders | Orders attributed to ads. | all |
| sales | Sales attributed to ads. | all |
| units | Units sold through ads. | total, by_ad_type |
| acos_percent | Cost ÷ sales × 100. | total, by_ad_type |
| roas | Sales ÷ cost. | total, by_ad_type |
| ad_type | SP, SB or SD. | by_ad_type |
| date | The day. | by_day |
What a row is about
Returned by get_campaigns, get_ad_groups, get_keywords, get_search_terms, get_placements, get_products
Names and settings come from the account structure, so they show the current name, state and bid. A field is present only where it applies.
| Field | Meaning | Where |
|---|---|---|
| campaign_id | Amazon's id of the campaign. | all except get_products |
| campaign | The campaign's name. | all except get_products |
| campaign_state | ENABLED, PAUSED or ARCHIVED. | all except get_products |
| ad_group_id | Amazon's id of the ad group. | get_ad_groups, get_keywords, get_search_terms |
| ad_group | The ad group's name. | get_ad_groups, get_keywords, get_search_terms |
| target_id | Amazon's id of the keyword or target. | get_keywords, get_search_terms |
| target_kind | keyword, target or theme_target. | get_keywords, get_search_terms |
| keyword | The keyword text. | get_keywords, get_search_terms |
| match_type | EXACT, PHRASE or BROAD. | get_keywords, get_search_terms |
| targeting | The expression of a product or automatic target, for example a product, a category or "close match". | get_keywords, get_search_terms |
| bid | The current bid. | get_keywords, get_search_terms |
| target_state | ENABLED, PAUSED or ARCHIVED. | get_keywords, get_search_terms |
| search_term | What the shopper typed, or the ASIN of the product page the ad showed on. | get_search_terms |
| placement | Where the ad appeared: top of search, product pages, rest of search, off Amazon. | get_placements |
| asin | The advertised product. | get_products |
Main figures and ratios
Returned by every performance tool
The six main figures are added up over the period. The ratios are worked out from those sums. Orders, sales and units use the standard attribution window (see How figures are calculated).
| Field | Meaning | Where |
|---|---|---|
| impressions | Times the ad was shown. | all |
| clicks | Clicks. | all |
| cost | Ad spend. | all |
| orders | Orders attributed to the ad. | all |
| sales | Sales attributed to the ad. | all |
| units | Units sold. | all |
| ctr_percent | Clicks ÷ impressions × 100. | all |
| cpc | Cost ÷ clicks. | all |
| conversion_percent | Orders ÷ clicks × 100. | all |
| acos_percent | Cost ÷ sales × 100. | all |
| roas | Sales ÷ cost. | all |
more: Sponsored Products
Returned by performance tools with ad_type SP
Everything else in Amazon's Sponsored Products reports. The window used for the main figures is not repeated here: on a seller account sales7d is already sales, on a vendor account sales14d is.
| Field | Meaning | Where |
|---|---|---|
| purchases1d | Orders, counted within 1 day of the click. | all |
| purchases7d | Orders, counted within 7 days of the click. | all |
| purchases14d | Orders, counted within 14 days of the click. | all |
| purchases30d | Orders, counted within 30 days of the click. | all |
| sales1d | Sales, counted within 1 day of the click. | all |
| sales7d | Sales, counted within 7 days of the click. | all |
| sales14d | Sales, counted within 14 days of the click. | all |
| sales30d | Sales, counted within 30 days of the click. | all |
| unitsSoldClicks1d | Units sold, counted within 1 day of the click. | all |
| unitsSoldClicks7d | Units sold, counted within 7 days of the click. | all |
| unitsSoldClicks14d | Units sold, counted within 14 days of the click. | all |
| unitsSoldClicks30d | Units sold, counted within 30 days of the click. | all |
| purchasesSameSku1d | Orders of the advertised product itself, counted within 1 day of the click. | all |
| purchasesSameSku7d | Orders of the advertised product itself, counted within 7 days of the click. | all |
| purchasesSameSku14d | Orders of the advertised product itself, counted within 14 days of the click. | all |
| purchasesSameSku30d | Orders of the advertised product itself, counted within 30 days of the click. | all |
| attributedSalesSameSku1d | Sales of the advertised product itself, counted within 1 day of the click. | all |
| attributedSalesSameSku7d | Sales of the advertised product itself, counted within 7 days of the click. | all |
| attributedSalesSameSku14d | Sales of the advertised product itself, counted within 14 days of the click. | all |
| attributedSalesSameSku30d | Sales of the advertised product itself, counted within 30 days of the click. | all |
| unitsSoldSameSku1d | Units of the advertised product itself, counted within 1 day of the click. | all |
| unitsSoldSameSku7d | Units of the advertised product itself, counted within 7 days of the click. | all |
| unitsSoldSameSku14d | Units of the advertised product itself, counted within 14 days of the click. | all |
| unitsSoldSameSku30d | Units of the advertised product itself, counted within 30 days of the click. | all |
| salesOtherSku7d | Sales of your other products after a click on this ad, within 7 days. | get_keywords, get_search_terms, get_products |
| unitsSoldOtherSku7d | Units of your other products after a click on this ad, within 7 days. | get_keywords, get_search_terms, get_products |
| addToList | Times a shopper added the product to a list after the ad. | all |
| topOfSearchImpressionShare | Share of top-of-search impressions you won, in percent.latest value | get_campaigns, get_keywords |
| keywordBid | The bid at the time of the report.latest value | get_keywords |
| campaignBudgetAmount | The campaign's budget at the time of the report.latest value | get_campaigns |
| campaignBiddingStrategy | The bidding strategy at the time of the report.latest value | get_campaigns |
| advertisedSku | The SKU of the advertised product.latest value | get_products |
more: Sponsored Brands
Returned by performance tools with ad_type SB
Everything else in Amazon's Sponsored Brands reports. get_search_terms has fewer figures than the other tools, because Amazon's search-term report has fewer.
| Field | Meaning | Where |
|---|---|---|
| purchasesClicks | Orders after a click (as opposed to after only seeing the ad). | all |
| purchasesPromoted | Orders of the products shown in the ad. | all except get_search_terms |
| salesClicks | Sales after a click. | all |
| salesPromoted | Sales of the products shown in the ad. | all except get_search_terms |
| unitsSoldClicks | Units sold after a click. | get_campaigns, get_ad_groups, get_placements |
| addToCart | Times a product was added to the basket. | all except get_search_terms |
| addToCartClicks | Add-to-basket events after a click. | all except get_search_terms |
| addToList | Times a shopper added a product to a list. | all |
| addToListFromClicks | Add-to-list events after a click. | all |
| brandedSearches | Searches for your brand name after the ad was seen. | all except get_search_terms |
| brandedSearchesClicks | Branded searches after a click. | all except get_search_terms |
| detailPageViews | Views of your product pages after the ad. | all except get_search_terms |
| detailPageViewsClicks | Product page views after a click. | all except get_search_terms |
| newToBrandPurchases | Orders from shoppers who had not bought from your brand in the past year. | all except get_search_terms |
| newToBrandPurchasesClicks | New-to-brand orders after a click. | all except get_search_terms |
| newToBrandSales | Sales to new-to-brand shoppers. | all except get_search_terms |
| newToBrandSalesClicks | New-to-brand sales after a click. | all except get_search_terms |
| newToBrandUnitsSold | Units sold to new-to-brand shoppers. | all except get_search_terms |
| newToBrandUnitsSoldClicks | New-to-brand units after a click. | all except get_search_terms |
| newToBrandDetailPageViews | Product page views by new-to-brand shoppers. | all except get_search_terms |
| newToBrandDetailPageViewsClicks | New-to-brand product page views after a click. | all except get_search_terms |
| viewableImpressions | Impressions that met the standard for being seen. | all |
| video5SecondViews | Video ads watched for at least 5 seconds. | all |
| videoFirstQuartileViews | Video ads watched to 25%. | all |
| videoMidpointViews | Video ads watched to 50%. | all |
| videoThirdQuartileViews | Video ads watched to 75%. | all |
| videoCompleteViews | Video ads watched to the end. | all |
| videoUnmutes | Times a shopper switched the sound on. | all |
| topOfSearchImpressionShare | Share of top-of-search impressions you won, in percent.latest value | get_campaigns, get_keywords |
| keywordBid | The bid at the time of the report.latest value | get_keywords |
| campaignBudgetAmount | The campaign's budget at the time of the report.latest value | get_campaigns |
| costType | How the campaign is charged: per click or per thousand viewable impressions.latest value | get_campaigns |
more: Sponsored Display
Returned by performance tools with ad_type SD
Everything else in Amazon's Sponsored Display reports. Display counts what happened after a click and after only seeing the ad separately.
| Field | Meaning | Where |
|---|---|---|
| purchasesClicks | Orders after a click (as opposed to after only seeing the ad). | all |
| purchasesPromotedClicks | Orders of the advertised products after a click. | all |
| salesClicks | Sales after a click. | all |
| salesPromotedClicks | Sales of the advertised products after a click. | all |
| unitsSoldClicks | Units sold after a click. | all |
| addToCart | Times a product was added to the basket. | all |
| addToCartClicks | Add-to-basket events after a click. | all |
| addToCartViews | Add-to-basket events after only seeing the ad. | all |
| addToList | Times a shopper added a product to a list. | all |
| addToListFromClicks | Add-to-list events after a click. | all |
| addToListFromViews | Add-to-list events after only seeing the ad. | all |
| brandedSearches | Searches for your brand name after the ad was seen. | all |
| brandedSearchesClicks | Branded searches after a click. | all |
| brandedSearchesViews | Branded searches after only seeing the ad. | all |
| detailPageViews | Views of your product pages after the ad. | all |
| detailPageViewsClicks | Product page views after a click. | all |
| impressionsViews | Viewable impressions. | all |
| newToBrandPurchases | Orders from shoppers who had not bought from your brand in the past year. | all |
| newToBrandPurchasesClicks | New-to-brand orders after a click. | all |
| newToBrandSales | Sales to new-to-brand shoppers. | all |
| newToBrandSalesClicks | New-to-brand sales after a click. | all |
| newToBrandUnitsSold | Units sold to new-to-brand shoppers. | all |
| newToBrandUnitsSoldClicks | New-to-brand units after a click. | all |
| videoFirstQuartileViews | Video ads watched to 25%. | all |
| videoMidpointViews | Video ads watched to 50%. | all |
| videoThirdQuartileViews | Video ads watched to 75%. | all |
| videoCompleteViews | Video ads watched to the end. | all |
| videoUnmutes | Times a shopper switched the sound on. | all |
| campaignBudgetAmount | The campaign's budget at the time of the report.latest value | get_campaigns |
| costType | How the campaign is charged: per click or per thousand viewable impressions.latest value | get_campaigns |
| promotedSku | The SKU of the advertised product.latest value | get_products |
product
Returned by get_products, get_search_terms (when the term is a product), get_structure (product ads)
What the Amazon Ads API knows about a product.
| Field | Meaning | Where |
|---|---|---|
| asin | The product's ASIN. | all |
| sku | Your SKU, when Amazon returns it. | all |
| title | The product title. | all |
| image_url | The main image as a 60-pixel thumbnail, served by Amazon. | all |
| image_url_large | The same image at 500 pixels. | all |
| brand | The brand. | all |
| category | The product's category on Amazon. | all |
| best_seller_rank | Its rank in that category. | all |
| price | The price a shopper pays. Amazon does not provide it for every product. | all |
| price_currency | The currency of the price. | all |
| list_price | The list price, when there is one. | all |
| availability | For example IN_STOCK, IN_STOCK_SCARCE, LEADTIME, OUT_OF_STOCK. | all |
| eligibility | ELIGIBLE or INELIGIBLE for advertising. | all |
| ineligibility_reasons | Why the product cannot be advertised, when it cannot. | all |
| variations | The ASINs of the product's variations. | all |
| created | When the product was created on Amazon. | all |
Sponsored Brands ads
Returned by get_ads
The campaign and ad group fields, the main figures, the ratios and more: Sponsored Brands as in the other performance tools, plus these.
| Field | Meaning | Where |
|---|---|---|
| ad_id | Amazon's id of the ad. | all |
| ad | The ad's name. | all |
| ad_state | ENABLED, PAUSED or ARCHIVED. | all |
| creative | The ad as Amazon holds it: type, headline, brand name, logo, custom images, the advertised ASINs and its review status. | all |
| landing_page | Where a click leads: a Store page, a product list or a custom address. | all |
Purchased products
Returned by get_purchased_products
What was bought after a click when it was not the advertised product. The envelope also has attribution_window: the window the three figures use.
| Field | Meaning | Where |
|---|---|---|
| advertised_asin | The product in the ad that was clicked. | SP, SD |
| advertised_product | Its details. See the product group. | SP, SD |
| purchased_asin | The product that was bought. | all |
| purchased_product | Its details. See the product group. | all |
| orders | Orders of the purchased product after a click on the ad. | all |
| sales | Sales of the purchased product. | all |
| units | Units of the purchased product. | all |
| campaigns | In how many campaigns this pair occurred. | all |
| more | Amazon's own columns for the pair: every attribution window for Sponsored Products (salesOtherSku1d to 30d and so on), new-to-brand figures for Sponsored Brands. | all |
Display matched targets
Returned by get_matched_targets
The campaign, ad group and target fields, the main figures, the ratios and more: Sponsored Display as in the other performance tools, plus these.
| Field | Meaning | Where |
|---|---|---|
| matched_asin | The product whose page the ad showed on. | all |
| product | That product's details. See the product group. | all |
Invalid traffic
Returned by get_invalid_traffic
Per campaign. impressions and clicks are the valid ones, the same figures the other tools return.
| Field | Meaning | Where |
|---|---|---|
| campaign | The campaign's name. Amazon gives no id in this report. | all |
| campaign_state | ENABLED, PAUSED or ARCHIVED, on the last day of the period.latest value | all |
| gross_impressions | Every impression Amazon counted, before removing invalid ones. | all |
| invalid_impressions | Impressions Amazon removed as invalid. | all |
| impressions | Gross minus invalid. | all |
| gross_clicks | Every click Amazon counted, before removing invalid ones. | all |
| invalid_clicks | Clicks Amazon removed as invalid. You are not charged for them. | all |
| clicks | Gross minus invalid. | all |
| invalid_impressions_percent | Invalid impressions ÷ gross impressions × 100. | all |
| invalid_clicks_percent | Invalid clicks ÷ gross clicks × 100. | all |
Product history
Returned by get_product_history
Recorded once a day. The envelope has history_starts: the first day that exists for the marketplace.
| Field | Meaning | Where |
|---|---|---|
| asin | The product. | all |
| category | The category the rank is in. | all |
| rank | Best-seller rank on the last recorded day of the period. 1 is the best.latest value | all |
| rank_at_start | Rank on the first recorded day of the period. | all |
| rank_change | rank minus rank_at_start. A negative number means the product climbed. | all |
| best_rank | The lowest rank number in the period. | all |
| worst_rank | The highest rank number in the period. | all |
| days_recorded | How many days of the period have a record. | all |
| history | One entry per day: date, rank, price, availability. | all |
| product | The product's current details. See the product group. | all |
Structure: every item
Returned by get_structure
The same columns for every kind of item. Below them, details holds Amazon's complete record, which differs per kind.
| Field | Meaning | Where |
|---|---|---|
| id | Amazon's id of the item. | all |
| type | The kind of item, for example campaign or negative_keyword. | all |
| ad_type | SP, SB, SD, or ALL for a portfolio. | all |
| campaign_id | The campaign it belongs to. | all |
| ad_group_id | The ad group it belongs to. | all |
| portfolio_id | The portfolio of a campaign. | all |
| name | Its name. | all |
| state | ENABLED, PAUSED or ARCHIVED. | all |
| bid | The bid of a keyword or target, or the default bid of an ad group. | all |
| budget | The budget of a campaign or portfolio. | all |
| keyword | The text of a keyword or negative keyword. | all |
| match_type | The match type of a keyword or negative keyword. | all |
| asin | The product of a product ad. | all |
| sku | The SKU of a product ad. | all |
| product | The product, for a product ad. See the product group. | all |
| details | Amazon's complete record. See the groups below. | all |
details: campaigns
Returned by get_structure with type campaign
Each ad type has its own record. The field names are Amazon's.
| Field | Meaning | Where |
|---|---|---|
| budget | Sponsored Products: an object with budget and budgetType. Brands and Display: the amount. | all |
| budgetType | DAILY or LIFETIME. | SB, SD |
| dynamicBidding.strategy | The bidding strategy: down only, up and down, or fixed bids. | SP |
| dynamicBidding.placementBidding | The bid adjustment per placement, in percent: top of search, product pages, rest of search. | SP |
| bidding | Bid optimisation and the bid adjustments per placement. | SB |
| targetingType | AUTO or MANUAL. | SP |
| startDate | The first day the campaign runs. | all |
| endDate | The last day, when one is set. | all |
| portfolioId | The portfolio the campaign is in. | all |
| costType | Charged per click or per thousand viewable impressions. | SB, SD |
| goal | The campaign's goal. | SB |
| kpi | The figure the goal is measured by. | SB |
| isMultiAdGroupsEnabled | Whether the campaign can hold several ad groups. | SB |
| smartDefault | Amazon's default targeting settings. | SB |
| tactic | The targeting tactic: products and categories, or audiences. | SD |
| deliveryProfile | How the budget is spread over the day. | SD |
| servingStatus | Whether Amazon is serving the campaign, and if not, why. | SD |
| creationDate | When the campaign was created. | SD |
| lastUpdatedDate | When it was last changed. | SD |
| tags | Your own labels on the campaign. | SP |
| offAmazonSettings | Settings for showing the ads outside Amazon. | SP |
| marketplaceBudgetAllocation | How a shared budget is split across marketplaces. | SP |
| extendedData.creationDateTime | When the item was created. | SP, SB |
| extendedData.lastUpdateDateTime | When it was last changed. | SP, SB |
| extendedData.servingStatus | Whether Amazon is currently serving it, and if not, why. | SP, SB |
| extendedData.servingStatusDetails | The reasons behind the serving status. | SP, SB |
details: ad groups, keywords, targets, ads
Returned by get_structure with type ad_group, keyword, target, negatives, product_ad, ad
The field names are Amazon's. Sponsored Products and Brands carry creation date and serving status in extendedData; Display has them at the top level.
| Field | Meaning | Where |
|---|---|---|
| defaultBid | The bid used when a keyword or target has none. | ad groups, SP and SD |
| bidOptimization | What Amazon optimises the ad group's bids for. | ad groups, SD |
| creativeType | Image or video. | ad groups, SD |
| keywordText | The keyword. | keywords, negative keywords |
| matchType | The match type. | keywords, negative keywords |
| bid | The bid. | keywords, targets |
| expression | What the target is aimed at, as you set it: a product, a category with filters, an audience, or an automatic group. | targets, negative targets |
| resolvedExpression | The same expression with names filled in, for example the category's name. | targets, negative targets |
| expressionType | AUTO or MANUAL. | targets, SP and SD |
| creative | The headline, logo, images, video and products of the ad. | ads, SB |
| landingPage | Where a click leads: a Store page, a product list or a custom address. | ads, SB |
| asin | The advertised product. | product ads |
| servingStatus | Whether Amazon is serving the item, and if not, why. | all |
| creationDate | When the item was created. | SD |
| lastUpdatedDate | When it was last changed. | SD |
| extendedData.creationDateTime | When the item was created. | SP, SB |
| extendedData.lastUpdateDateTime | When it was last changed. | SP, SB |
| extendedData.servingStatus | Whether Amazon is currently serving it, and if not, why. | SP, SB |
| extendedData.servingStatusDetails | The reasons behind the serving status. | SP, SB |
details: portfolios
Returned by get_structure with type portfolio
A portfolio groups campaigns of any ad type.
| Field | Meaning | Where |
|---|---|---|
| budget | The portfolio's budget cap, when it has one. | all |
| budgetControls | How the cap applies: monthly, a date range, or none. | all |
| inBudget | Whether the portfolio is still inside its budget. | all |
| extendedData.creationDateTime | When the item was created. | all |
| extendedData.lastUpdateDateTime | When it was last changed. | all |
| extendedData.servingStatus | Whether Amazon is currently serving it, and if not, why. | all |
| extendedData.servingStatusDetails | The reasons behind the serving status. | all |
How to read the list
- all in the last column means the field is in every answer of that group.
- latest value marks a value that describes a state, such as a bid or a budget. It is not added up over the days of the period; you get the most recent one.
- A field is left out of an answer when it has no value or is zero for the whole period. A missing figure reads as zero.
- Sponsored Products figures come in four attribution windows:
1d,7d,14dand30d. See How figures are calculated.