Get Optimizer Settings
GET/api/advertising/optimizer/settings
Returns the bid optimizer's mode, whether auto mode is unlocked, and the latest bid-model backtest.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.view permission; the tenant must have the advertising-manager feature enabled.
Modes: off (no scheduled runs), monitor (estimates only, no change sets), suggest (each run creates a pending change set for review), auto (change sets are applied without review).
Response fields:
optimizer_mode: the stored mode (off, monitor, suggest, auto; default monitor).effective_mode: the mode runs actually use; a storedautoruns assuggestonce the passing backtest is older than the validity window (30 days by default).auto_unlocked: whether the latest backtest beats the baseline and is recent enough to allowauto.auto_blocked_reason: whyautois not available (null when unlocked).backtest: the latest backtest result or null:outcome(passed, failed, insufficient_data),ran_at,ad_account_ids,targets_evaluated, calibration error for the model and for raw per-target conversion rates (lower is better),calibration_buckets, contribution of the model's bids vs the bid-to-target-POAS rule,lift_pct,beats_baseline,message.
Request
Responses
- 200
- 401
- 403
- 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.
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.