Get Experiment Results
GET/api/advertising/experiments/:experiment/results
Returns the experiment's results: stored final results for a stopped or completed experiment, otherwise interim results computed now (interim: true).
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
For each metric (contribution_after_ads, units, attributed_units, tacos, all per product per day over window) the treatment and control means, their difference (treatment - control), standard error and 95% confidence interval; significant is true when the interval excludes zero. For guardrail-policy experiments, control products that still received Critical guardrail actions are excluded and listed in excluded. When measurable, incrementality_factor (0-1) and, for guardrail-policy experiments, measured_savings are included. Before the first complete day, metrics is empty and note explains why.
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.