Get reporting metrics

GET /api/v2/buyer/reporting/metrics Returns delivery metrics rolled up across the advertiser → campaign → media buy → package tree. Choose a hierarchical summary or flat timeseries view, scope with advertiserId and campaignId, and set the window with days or an explicit startDate/endDate. This endpoint is day-grain only — for hourly counts use Get event summary.

Request

curl "https://api.interchange.io/api/v2/buyer/reporting/metrics?days=14&advertiserId=42&demo=false" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

curl "https://api.interchange.io/api/v2/buyer/reporting/metrics?view=timeseries&days=90&download=true&demo=false" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Param	Type	Required	Notes
`advertiserId`	string	No	Filter to one advertiser
`campaignId`	string	No	Filter to one campaign. Must belong to `advertiserId` if both are passed
`startDate`	string	No	`YYYY-MM-DD`. Overrides the `days` window when set
`endDate`	string	No	`YYYY-MM-DD`. Defaults to today
`days`	integer	No	`0`–`90`, default `7`. Use `0` for the full campaign timeframe
`view`	enum	No	`summary` (default) or `timeseries`
`download`	boolean	No	Default `false`. When `true`, returns a signed CSV URL instead of JSON
`demo`	boolean	No	Default `false`. When `true`, returns auto-generated demo data instead of real data

Response

{
  "advertisers": [
    {
      "advertiserId": "42",
      "advertiserName": "Northwind Outdoors",
      "metrics": { "impressions": 12345, "spend": 678.9, "clicks": 210, "views": 9800, "completedViews": 4200, "conversions": 18, "leads": 3, "videoCompletions": 4200, "ecpm": 55.0, "cpc": 3.23, "ctr": 0.017, "completionRate": 0.43 },
      "campaigns": [
        {
          "campaignId": "cmp_001",
          "campaignName": "Spring Trail Series",
          "management": "managed",
          "metrics": { "impressions": 12345, "spend": 678.9, "clicks": 210, "views": 9800, "completedViews": 4200, "conversions": 18, "leads": 3, "videoCompletions": 4200, "ecpm": 55.0, "cpc": 3.23, "ctr": 0.017, "completionRate": 0.43 },
          "mediaBuys": []
        }
      ]
    }
  ],
  "totals": { "impressions": 12345, "spend": 678.9, "clicks": 210, "views": 9800, "completedViews": 4200, "conversions": 18, "leads": 3, "videoCompletions": 4200, "ecpm": 55.0, "cpc": 3.23, "ctr": 0.017, "completionRate": 0.43 },
  "periodStart": "2026-05-24",
  "periodEnd": "2026-06-06"
}

Each campaign block (and each timeseries row) carries a management state: tracked (a campaign you did not set up through the platform, mirrored read-only from a connected seller account) or managed (authored or adopted through the platform). This surface currently reports managed campaigns only — tracked mirror delivery is excluded — so totals never silently mix the two states. When download=true, the response is instead { downloadUrl, expiresAt, fileName, rowCount } with a signed URL that expires in 7 days. Treat that URL as a bearer credential.

Errors

400 VALIDATION_ERROR — malformed startDate/endDate, days outside 0–90, or a campaignId that does not belong to the given advertiserId.

See Errors for the full error contract.

Reporting tasks

All reporting operations

Reporting overview guide

Hierarchy, metrics, CSV export, delivery flow

Get event summary

Hourly event counts by type

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Reporting tasks

Reporting overview guide

Get event summary

​Request

​Parameters

​Response

​Errors

​Related

Reporting tasks

Reporting overview guide

Get event summary

Request

Parameters

Response

Errors

Related