---
title: "Generate optimizer daily brief and plan"
method: POST
path: "/optimizer-daily-brief"
---

# Generate optimizer daily brief and plan

`POST /optimizer-daily-brief`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/optimizer-daily-brief`
- Auth: HTTP bearer

Returns a localized customer-first daily brief for the current optimizer scope. Supports locale en/zh/ja. Read-only; does not create drafts or write ad platforms.

## Request body

- object
  - `operator_id` string
  - `report_date` string: YYYY-MM-DD
  - `report_options` object
    - `timezone` string: IANA timezone used to close calendar windows; metric dates retain provider timezone semantics.
    - `aggregation_method` 'daily_arithmetic_mean' | 'pooled_ratio'
    - `baseline_includes_target` boolean
    - `period_kind` 'natural_week' | 'custom_period'
  - `report_thresholds` object
  - `date` string: Alias of report_date
  - `customer_name` string
  - `limit` integer
  - `locale` 'en' | 'zh' | 'ja': Human-facing output locale.

## Response `200`

Optimizer daily brief

- object
  - `schema_version` 'gravityads.optimizer_daily_brief.v2', required
  - `status` 'optimizer_daily_brief_ready', required
  - `report_type` string, required
  - `operator_id` string
  - `report_date` string
  - `language` string
  - `requested_locale` string
  - `supported_locales` string[]
  - `generated_at_utc` string
  - `summary` object, required
  - `summary_cn` string, required
  - `summary_text` string, required
  - `localized` object
  - `recommended_prompts` string[]
  - `performance_overview` object
  - `optimization_suggestions` object[]
  - `customer_sections` object[], required
  - `top_candidates` object[], required
  - `feedback_tasks` object
  - `data_window` object
  - `todays_plan_cn` string[]
  - `attention_items_cn` string[]
  - `risks_and_checks_cn` string[]
  - `hosted_auth_context` object, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)