Creative Report

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/creative/?date_from=2026-01-01&date_to=2026-01-07&advertiser_id=544' \
    --header 'X-Api-Key: YOUR_API_KEY'

  curl --request GET \
    --url 'https://api.growthchannel.io/creative/?date_from=2026-01-01&date_to=2026-01-07&advertiser_id=544&with_campaign=true&search=banner&sort_column=ctr&sort_order=DESC&page=1' \
    --header 'X-Api-Key: YOUR_API_KEY'

Method

GET

Endpoint

/creative/

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.

integer

Return data for one campaign only.

boolean

default:"false"

Split each creative by campaign and add campaign_ids to each row. Accepts true/false, 1/0, yes/no.

string

Filter by part of the creative name (case-insensitive).

string

default:"impressions"

Column to sort by. One of: creative_name, impressions, clicks, total_conversions, engagements, video_audio_views, video_audio_complete, total_revenue, total_spend, cpm, cpc, cpa, cpv, cpv_video, cpcv_video, roas, ctr, vcr.

string

default:"DESC"

Sort direction: ASC or DESC (case-insensitive).

integer

default:"0"

Page number, starting at 1. Each page has 20 rows. Omit or send 0 to get all rows.

Responses

200 OK
400 Bad Request
401 Unauthorized
500 Internal Server Error

{
  "data": [
    {
      "creative_name": "Spring Banner 300x250",
      "impressions": 208,
      "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,
      "ctr": 0.481,
      "vcr": 0.0,
      "campaign_ids": {
        "growth": [11111]
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 100
  },
  "with_campaign": true,
  "search": "banner"
}

array

An array of creative performance objects.

Show object

string

The creative name.

integer

Delivery counts.

number

Conversion revenue and spend.

number

Calculated metrics. See Metrics.

object

The campaign ID, as {"growth": [id]}. Present only when with_campaign=true.

object

An object containing pagination details.

Show object

integer

The requested page. 0 when all rows are returned.

integer

Total number of 20-row pages.

integer

Total number of records.

boolean

The with_campaign value used for the request.

string | null

The search value used for the request.

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": "..."
  }
}

Returned if sort_column or sort_order is not one of the allowed values.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid sort_column: reach",
    "details": {
      "sort_column": "reach"
    },
    "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