---
title: "Summary"
method: GET
path: "/api/insights/summary"
tags: ["insights"]
---

# Summary

`GET /api/insights/summary`

## Request

- Base URL: `https://api.advisorppc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.advisorppc.com/api/insights/summary`
- Auth: HTTP bearer

## Query parameters

- `platform` string, nullable: Narrow the report to one provider, e.g. google_ads.
- `accountId` string, nullable: Narrow the report to one account of that provider.

## Headers

- `X-Tenant-Id` integer, nullable

## Response `200`

Successful Response

- InsightsSummaryOut
  - `kpis` KpiOut[], required
    - `label` string, required
    - `value` string, required
    - `delta` string, nullable
  - `spendTrend` SpendPointOut[], required
    - `date` string, required
    - `spend` number, required
  - `byPlatform` PlatformRowOut[], required
    - `platform` string, required
    - `spend` number, required
    - `clicks` integer, required
    - `impressions` integer, required
    - `conversions` number, required
    - `revenue` number
    - `roas` number, nullable
    - `cpa` number, nullable
    - `ctr` number, nullable
    - `convRate` number, nullable
    - `spendShare` number
    - `spendDelta` string, nullable
    - `revenueDelta` string, nullable
    - `verdict` string
    - `verdictLabel` string
    - `verdictDetail` string
  - `reporting` InsightsReportingOut: Why the summary is empty or zero — never a substitute for numbers.
    - `state` string, required
    - `managed_account_count` integer, required
    - `detail` string, required
    - `connectors_url` string, required
    - `since` string, nullable
    - `until` string, nullable
    - `observed_at` string, nullable
    - `currency` string, nullable
  - `benchmark` InsightsBenchmarkOut: The yardstick every platform verdict was measured against.
    - `basis` string, required
    - `value` number, nullable
    - `source` string
    - `detail` string

## Other responses

- `422`: Validation Error

---

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