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.
advertising:readGrant 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
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.