---
title: "Insights Summary"
method: GET
path: "/api/v1/openai-ads/insights/summary"
tags: ["openaiAds"]
---

# Insights Summary

`GET /api/v1/openai-ads/insights/summary`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/openai-ads/insights/summary`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `account_id` string, required: Quickads id of the connected ad account
- `days` integer: Trailing whole days in the ad account's timezone, today included
- `campaign_id` string: A campaign id, or 'all' for the whole account
- `since` string, date, nullable
- `until` string, date, nullable

## Response `200`

Successful Response

- OpenAIAdsResponseDTOInsightsSummaryDTO
  - `code` integer
  - `message` string
  - `data` InsightsSummaryDTO, required
    - `currency` string, required
    - `timezone` string, required
    - `totals` MetricTotalsDTO, required
      - `impressions` number
      - `clicks` number
      - `spend` number
      - `conversions` number
      - `ctr` number
      - `cpc` number
      - `cpm` number
      - `cpa` number
    - `previous_totals` MetricTotalsDTO, required
      - `impressions` number
      - `clicks` number
      - `spend` number
      - `conversions` number
      - `ctr` number
      - `cpc` number
      - `cpm` number
      - `cpa` number
    - `daily` DailyRowDTO[]
      - `date` string, required
      - `impressions` number
      - `clicks` number
      - `spend` number
      - `conversions` number
      - `is_provisional` boolean
    - `provisional_from` string, required
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-22** `23eb62d854e6`: 2 info
  - added the new optional `query` request parameter `since`
  - added the new optional `query` request parameter `until`
- **2026-10-13** `c7202552278d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/insights/summary/get.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)