Skip to main content

Get Product Organic Halo

GET 

/api/advertising/products/:product/organic-halo

Returns a product's organic halo: weekly buckets (oldest first) through yesterday of total channel units, ad-attributed units, organic units (total - attributed, never below 0), paid share, ad spend, channel revenue and TACoS (spend / revenue), from orders on the sales channels the product is advertised on, plus window totals.

Required scope: advertising:read

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

flag.rising_tacos_flat_organic is true when TACoS in the last half of the window is at least 10% higher than the first half while organic units moved less than 5%. search_terms lists up to 20 top search terms by ad spend over the last 30 days; query_share is filled only when Amazon Brand Analytics data is available (see brand_analytics).

Query: weeks (optional, default 12, clamped to 2-52).

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