Campaign Performance

Maximum date range 365 days

This endpoint is protected and requires an agency API key for access.

  curl --request GET \
    --url 'https://api.growthchannel.io/performance/?date_from=2026-01-01&date_to=2026-01-03' \
    --header 'X-Api-Key: YOUR_API_KEY'

  curl --request GET \
    --url 'https://api.growthchannel.io/performance/?date_from=2026-01-01&date_to=2026-01-03&advertiser_id=544' \
    --header 'X-Api-Key: YOUR_API_KEY'

Method

GET

Endpoint

/performance/

Returns one row per campaign per day, sorted by impressions (highest first). All rows are returned in one response.

Headers

string

required

The agency’s API key for authorization. Contact an admin to get one.

Parameters

string

required

Start date in YYYY-MM-DD format.

string

required

End date in YYYY-MM-DD format.

integer

Return data for one advertiser only. Omit to get all advertisers accessible to your key.

integer

Return data for one agency only. It must be your agency or an agency in your portfolio.

Responses

200 OK
400 Bad Request
401 Unauthorized
500 Internal Server Error

{
  "data": [
    {
      "date": "2026-01-02",
      "campaign_name": "Name | Name2 | 11111",
      "impressions": 208,
      "reach": 150,
      "frequency": 1.387,
      "clicks": 1,
      "total_conversions": 0,
      "engagements": 0,
      "video_audio_views": 0,
      "video_audio_complete": 0,
      "total_revenue": 0.0,
      "total_spend": 0.909,
      "cpm": 4.37,
      "cpc": 0.909,
      "cpa": 0.0,
      "cpv": 0.004,
      "cpv_video": 0.0,
      "cpcv_video": 0.0,
      "roas": 0.0,
      "matched_bid_opp": 393941,
      "vcr": 0.0,
      "ctr": 0.481,
      "campaign_ids": {
        "growth": [11111]
      },
      "advertiser_ids": {
        "growth": [544]
      }
    }
  ],
  "pagination": {
    "total_records": 100,
    "total_pages": 5
  },
  "parameters": {
    "date_from": "2026-01-01",
    "date_to": "2026-01-03",
    "agency_ids": [101],
    "advertiser_id": 544
  }
}

array

An array of campaign performance objects, one per campaign per day.

Show object

string

The day, in YYYY-MM-DD format.

string

The campaign name.

integer

Number of impressions.

integer

Number of unique users reached.

number

Impressions / reach.

integer

Number of clicks.

integer

Number of conversions.

integer

Number of engagements.

integer

Number of video or audio views.

integer

Number of completed video or audio views.

number

Conversion revenue.

number

Spend.

integer

Number of matched bid opportunities.

number

Calculated metrics. See Metrics.

object

The campaign ID, as {"growth": [id]}.

object

The advertiser ID, as {"growth": [id]}.

object

An object containing the record count.

Show object

integer

The total number of records found.

integer

The number of 20-row pages the records would fill. All records are returned in data.

object

The parameters used for the request.

Show object

string

Start date.

string

End date.

integer[]

The agencies included in the report.

integer

The advertiser included in the report. Present only when the report covers one advertiser.

Returned if a parameter is missing or invalid. See Errors for all messages.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required parameters",
    "details": {
      "missing_fields": ["date_from", "date_to"]
    },
    "request_id": "..."
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "advertiser_id is not associated with the agency",
    "details": {
      "advertiser_id": 544
    },
    "request_id": "..."
  }
}

Returned if the X-Api-Key header is missing or invalid.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key",
    "details": {
      "field": "X-Api-Key",
      "issue": "invalid"
    },
    "request_id": "..."
  }
}

API documentation

Public endpoints

Method

Endpoint

Headers

Parameters

Responses

Method

Endpoint

​Headers

​Parameters

​Responses

Headers

Parameters

Responses