Domain 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/domain/?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/domain/?date_from=2026-01-01&date_to=2026-01-07&advertiser_id=544&domain_type=APP&page=1' \
    --header 'X-Api-Key: YOUR_API_KEY'

Method

GET

Endpoint

/domain/

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.

string

Return only websites (WEB) or only apps (APP). Case-insensitive. Omit to get both.

string

default:"impressions"

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

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": [
    {
      "site_domain": "example.com",
      "app_name": null,
      "env_type": "WEB",
      "impressions": 1200,
      "clicks": 45,
      "total_conversions": 3,
      "video_audio_views": 300,
      "video_audio_complete": 190,
      "total_revenue": 120.3,
      "total_spend": 56.0,
      "cpm": 46.667,
      "cpc": 1.244,
      "cpa": 18.667,
      "cpv": 0.047,
      "cpv_video": 0.187,
      "cpcv_video": 0.295,
      "roas": 2.148,
      "vcr": 63.333,
      "ctr": 3.75
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 100
  }
}

array

An array of domain performance objects.

Show object

string | null

The website domain.

string | null

The app name, for app inventory.

string

The environment: WEB or APP.

integer

Delivery counts.

number

Conversion revenue and spend.

number

Calculated metrics. See Metrics.

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.

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: domain",
    "details": {
      "sort_column": "domain"
    },
    "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