Skip to main content

List Anomalies

GET 

/api/advertising/anomalies

Returns a paginated list of detected anomalies, most recent window first (then newest ID first). Sorting is fixed.

Required scope: advertising:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Filters:

  • filter[status]: open, resolved or dismissed.
  • filter[ad_account_id]: ad account ID.
  • filter[product_id]: product ID.
  • filter[metric]: spend, cpc, ctr, cvr, impressions, acos, poas, budget_out_hour or account_storm (an account-wide anomaly).

Pagination: per_page (default 10).

Window times are UTC (ISO 8601); ratio metrics are fractions (0.25 = 25%). matched_causes lists the detected causes (price_change, stock_change, buy_box_lost, listing_suppressed, sku_change, external_change, competitor_stockout, deal_window, platform_reporting) with a 0-1 confidence.

Requires the advertising.view permission.

Available only when the tenant has both the advertising and advertising-manager features enabled; otherwise every route here returns 404.

Request​

Responses​

OK

Response Headers
    Content-Type