list_negative_targets
The seller's NEGATIVE keywords and negative product targets — the traffic they deliberately blocked. Answers: is this query already negated, which campaigns block a brand, what did we exclude at the ad-group level. This is a LIST of rules, not metrics: a negation has no spend, no clicks and no period, so there is nothing here to sum or compare — for the spend a query wasted, use query_search_terms. The classic workflow is the pair: query_search_terms with metricFilters spend > X AND sales < 1 gives the negative CANDIDATES, then this tool tells you which of them are already negated. level is where the rule lives (campaign or ad_group), kind is what it blocks (keyword or product_target); a keyword negation carries keywordText + matchType, a product target carries expressionType + expressionValue (an ASIN or a brand id). Requires the ads entity snapshot to be built for the account. 🧭 SPONSORED PRODUCTS ONLY: no Sponsored Brands / Sponsored Display negative list is ingested yet, so adProducts accepts only sponsored_products (any other value is refused with a message saying so, never answered with the SP list under another name) and every row carries adProduct: 'sponsored_products'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Case-insensitive substring over the negated keyword text AND the product-target expression value. | |
| kinds | No | What is negated: keyword (a customer query) or product_target (an ASIN/brand). | |
| limit | No | ||
| levels | No | Where the negation lives: campaign or ad_group. | |
| offset | No | Row offset for pagination (default 0). | |
| reason | No | One sentence, ALWAYS IN ENGLISH (regardless of the conversation language), on WHY you are making this call — the user question or your analytical goal. Recorded so the seller can see how their data is used. | |
| sortBy | No | ||
| states | No | Amazon states, e.g. ENABLED. | |
| accounts | No | Restrict to a subset of your own seller account IDs (from list_accounts). Omit to include all your accounts. A brand/account name is accepted and resolved to its id when it matches one of your accounts unambiguously; a label that carries the id ("Brand (A1B2C3D4E5F6G)") resolves to that id. | |
| channels | No | ONE Amazon programme per call. 'SELLER' = Seller Central (3P) advertising: the seller's own Amazon Ads campaigns. 'VENDOR' = Vendor Central (1P) advertising: the campaigns of the vendor's own Amazon Ads profile. Omit = SELLER whenever the accounts of the call include a Seller Central account, else VENDOR. Pass ['VENDOR'] only when the user asks about Vendor Central / 1P advertising. Both at once is refused: 3P and 1P spend and sales are never added into one total. | |
| sortOrder | No | asc (default). | |
| adGroupIds | No | Restrict to these ad groups. | |
| adProducts | No | Which ad products' negatives to list. Only sponsored_products is served today; other values are refused by name. | |
| campaignIds | No | Restrict to these campaigns. | |
| marketplaces | No | Marketplace IDs. |