---
title: "Get aggregate ad campaign stats"
method: GET
path: "/campaigns/ads/stats/"
tags: ["campaigns"]
---

# Get aggregate ad campaign stats

`GET /campaigns/ads/stats/`

## Request

- Base URL: `https://api.hive.co/v2`
- URL: `https://api.hive.co/v2/campaigns/ads/stats/`
- Auth: HTTP bearer

One set of stats totalled across published ad campaigns. Spend and counts are summed; derived metrics (cost per click, CTR, frequency, ROAS) are recalculated from the sums. Reach is a sum of per-campaign reach, so audience overlap across campaigns is counted once per campaign. `created_after` is inclusive and `created_before` exclusive.

## Query parameters

- `campaign_ids` string
- `created_after` string, date-time
- `created_before` string, date-time

## Headers

- `X-Partner-Id` string, required

## Response `200`

- AggregateAdsCampaignStatsResponse
  - `campaigns_included` integer, required
  - `stats_refreshed_at` string, date-time, nullable, required
  - `stats` AdsCampaignStats, required: Versioned view over the cached Meta lifetime insights — the raw insights blob is never passed through. All figures are Meta-reported; ads have no Hive-attributed revenue sections (unlike email and SMS).
    - `spend` number, double
    - `impressions` integer
    - `reach` integer
    - `frequency` number, double
    - `clicks` integer
    - `unique_clicks` integer
    - `cost_per_click` number, double
    - `cost_per_unique_click` number, double
    - `click_through_rate` number, double
    - `results` integer
    - `cost_per_result` number, double
    - `meta_purchase_value` number, double
    - `meta_purchase_roas` number, double

## Other responses

- `422`: The request was rejected on its query parameters. Field errors are keyed by parameter name, rejections on the parameter values (e.g. an unknown ID) use a flat `errors` list.

---

[API](https://skmtc.dev/hive-co/apis/hive-api.md) - [All operations](https://skmtc.dev/hive-co/apis/hive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hive-co/apis/hive-api/revisions/aa145f089347?raw)