Creative Daily Metrics

GET/api/v1/analytics/creatives/daily

Authorization

AuthorizationBearer token · headerrequired

AuthorizationOAuth2 access token · headerrequired

Query parameters

date_fromstring<date> | any

date_tostring<date> | any

productstring[] | any

platformstring[] | any

media_sourcestring[] | any

countrystring[] | any

ad_typestring[] | any

reelsstring[] | any

assigneestring[] | any

task_ownerstring[] | any

subjectstring[] | any

topicstring[] | any

subtopicstring[] | any

geostring[] | any

languagestring[] | any

created_fromstring<date> | any

created_tostring<date> | any

creo_namestring | any

Exact creative name

searchstring | any

Substring match on creative/campaign/ad set names

granularitystring

default: "day"

Allowed:dayweekmonth

all_timeboolean

default: false

breakdownstring | any

breakdown_limitinteger

min 1 · max 20 · default: 5

Responses

200Successful Response

successboolean

default: true

dataDailyAnalyticsResult | any

Show properties

Any of:

DailyAnalyticsResult

daysDailyMetricsPoint[]required

Show properties

Array of DailyMetricsPoint

datestring<date>required

impressionsintegerrequired

clicksintegerrequired

video_viewsintegerrequired

hooksintegerrequired

installsintegerrequired

purchasesintegerrequired

base_purchinteger

default: 0

trialsinteger

default: 0

spend_usdnumberrequired

ltvnumberrequired

roasnumber | any

Show properties

Any of:

number

number

any

any

romi_pctnumber | any

Show properties

Any of:

number

number

any

any

cr_pctnumber | any

Show properties

Any of:

number

number

any

any

ctr_pctnumber | any

Show properties

Any of:

number

number

any

any

c2i_pctnumber | any

Show properties

Any of:

number

number

any

any

i2l_pctnumber | any

Show properties

Any of:

number

number

any

any

hook_rate_pctnumber | any

Show properties

Any of:

number

number

any

any

hold_rate_pctnumber | any

Show properties

Any of:

number

number

any

any

ipmnumber | any

Show properties

Any of:

number

number

any

any

cpmnumber | any

Show properties

Any of:

number

number

any

any

cpcnumber | any

Show properties

Any of:

number

number

any

any

cpinumber | any

Show properties

Any of:

number

number

any

any

cpanumber | any

Show properties

Any of:

number

number

any

any

previous_daysDailyMetricsPoint[]required

Show properties

Array of DailyMetricsPoint

datestring<date>required

impressionsintegerrequired

clicksintegerrequired

video_viewsintegerrequired

hooksintegerrequired

installsintegerrequired

purchasesintegerrequired

base_purchinteger

default: 0

trialsinteger

default: 0

spend_usdnumberrequired

ltvnumberrequired

roasnumber | any

Show properties

Any of:

number

number

any

any

romi_pctnumber | any

Show properties

Any of:

number

number

any

any

cr_pctnumber | any

Show properties

Any of:

number

number

any

any

ctr_pctnumber | any

Show properties

Any of:

number

number

any

any

c2i_pctnumber | any

Show properties

Any of:

number

number

any

any

i2l_pctnumber | any

Show properties

Any of:

number

number

any

any

hook_rate_pctnumber | any

Show properties

Any of:

number

number

any

any

hold_rate_pctnumber | any

Show properties

Any of:

number

number

any

any

ipmnumber | any

Show properties

Any of:

number

number

any

any

cpmnumber | any

Show properties

Any of:

number

number

any

any

cpcnumber | any

Show properties

Any of:

number

number

any

any

cpinumber | any

Show properties

Any of:

number

number

any

any

cpanumber | any

Show properties

Any of:

number

number

any

any

totalsPeriodTotalsrequired

Totals over one comparison period (ratio-of-sums for derived metrics).

Show properties

impressionsintegerrequired

clicksintegerrequired

video_viewsintegerrequired

hooksintegerrequired

installsintegerrequired

purchasesintegerrequired

spend_usdnumberrequired

ltvnumberrequired

roasnumber | any

Show properties

Any of:

number

number

any

any

romi_pctnumber | any

Show properties

Any of:

number

number

any

any

cr_pctnumber | any

Show properties

Any of:

number

number

any

any

ctr_pctnumber | any

Show properties

Any of:

number

number

any

any

cpanumber | any

Show properties

Any of:

number

number

any

any

previous_totalsPeriodTotalsrequired

Totals over one comparison period (ratio-of-sums for derived metrics).

Show properties

impressionsintegerrequired

clicksintegerrequired

video_viewsintegerrequired

hooksintegerrequired

installsintegerrequired

purchasesintegerrequired

spend_usdnumberrequired

ltvnumberrequired

roasnumber | any

Show properties

Any of:

number

number

any

any

romi_pctnumber | any

Show properties

Any of:

number

number

any

any

cr_pctnumber | any

Show properties

Any of:

number

number

any

any

ctr_pctnumber | any

Show properties

Any of:

number

number

any

any

cpanumber | any

Show properties

Any of:

number

number

any

any

seriesBreakdownSeries[]

default: []

Show properties

Array of BreakdownSeries

valuestringrequired

pointsDailyMetricsPoint[]required

Show properties

Array of DailyMetricsPoint

datestring<date>required

impressionsintegerrequired

clicksintegerrequired

video_viewsintegerrequired

hooksintegerrequired

installsintegerrequired

purchasesintegerrequired

base_purchinteger

default: 0

trialsinteger

default: 0

spend_usdnumberrequired

ltvnumberrequired

roasnumber | any

Show properties

Any of:

number

number

any

any

romi_pctnumber | any

Show properties

Any of:

number

number

any

any

cr_pctnumber | any

Show properties

Any of:

number

number

any

any

ctr_pctnumber | any

Show properties

Any of:

number

number

any

any

c2i_pctnumber | any

Show properties

Any of:

number

number

any

any

i2l_pctnumber | any

Show properties

Any of:

number

number

any

any

hook_rate_pctnumber | any

Show properties

Any of:

number

number

any

any

hold_rate_pctnumber | any

Show properties

Any of:

number

number

any

any

ipmnumber | any

Show properties

Any of:

number

number

any

any

cpmnumber | any

Show properties

Any of:

number

number

any

any

cpcnumber | any

Show properties

Any of:

number

number

any

any

cpinumber | any

Show properties

Any of:

number

number

any

any

cpanumber | any

Show properties

Any of:

number

number

any

any

totalsPeriodTotalsrequired

Totals over one comparison period (ratio-of-sums for derived metrics).

Show properties

impressionsintegerrequired

clicksintegerrequired

video_viewsintegerrequired

hooksintegerrequired

installsintegerrequired

purchasesintegerrequired

spend_usdnumberrequired

ltvnumberrequired

roasnumber | any

Show properties

Any of:

number

number

any

any

romi_pctnumber | any

Show properties

Any of:

number

number

any

any

cr_pctnumber | any

Show properties

Any of:

number

number

any

any

ctr_pctnumber | any

Show properties

Any of:

number

number

any

any

cpanumber | any

Show properties

Any of:

number

number

any

any

metaDailyAnalyticsMetarequired

Show properties

date_fromstring<date>required

date_tostring<date>required

prev_date_fromstring<date>required

prev_date_tostring<date>required

granularitystringrequired

Allowed:dayweekmonth

breakdownstring | any

Show properties

Any of:

string

string

any

any

all_timeboolean

default: false

any

any

messagestring | any

Show properties

Any of:

string

string

any

any

errorsstring[] | any

Show properties

Any of:

string[]

Array of string

string

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X GET "/api/v1/analytics/creatives/daily" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/api/v1/analytics/creatives/daily", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "/api/v1/analytics/creatives/daily",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "success": true,
  "data": {
    "days": [
      {
        "date": "2019-08-24",
        "impressions": 0,
        "clicks": 0,
        "video_views": 0,
        "hooks": 0,
        "installs": 0,
        "purchases": 0,
        "base_purch": 0,
        "trials": 0,
        "spend_usd": 0,
        "ltv": 0,
        "roas": 0,
        "romi_pct": 0,
        "cr_pct": 0,
        "ctr_pct": 0,
        "c2i_pct": 0,
        "i2l_pct": 0,
        "hook_rate_pct": 0,
        "hold_rate_pct": 0,
        "ipm": 0,
        "cpm": 0,
        "cpc": 0,
        "cpi": 0,
        "cpa": 0
      }
    ],
    "previous_days": [
      {
        "date": "2019-08-24",
        "impressions": 0,
        "clicks": 0,
        "video_views": 0,
        "hooks": 0,
        "installs": 0,
        "purchases": 0,
        "base_purch": 0,
        "trials": 0,
        "spend_usd": 0,
        "ltv": 0,
        "roas": 0,
        "romi_pct": 0,
        "cr_pct": 0,
        "ctr_pct": 0,
        "c2i_pct": 0,
        "i2l_pct": 0,
        "hook_rate_pct": 0,
        "hold_rate_pct": 0,
        "ipm": 0,
        "cpm": 0,
        "cpc": 0,
        "cpi": 0,
        "cpa": 0
      }
    ],
    "totals": {
      "impressions": 0,
      "clicks": 0,
      "video_views": 0,
      "hooks": 0,
      "installs": 0,
      "purchases": 0,
      "spend_usd": 0,
      "ltv": 0,
      "roas": 0,
      "romi_pct": 0,
      "cr_pct": 0,
      "ctr_pct": 0,
      "cpa": 0
    },
    "previous_totals": {
      "impressions": 0,
      "clicks": 0,
      "video_views": 0,
      "hooks": 0,
      "installs": 0,
      "purchases": 0,
      "spend_usd": 0,
      "ltv": 0,
      "roas": 0,
      "romi_pct": 0,
      "cr_pct": 0,
      "ctr_pct": 0,
      "cpa": 0
    },
    "series": [],
    "meta": {
      "date_from": "2019-08-24",
      "date_to": "2019-08-24",
      "prev_date_from": "2019-08-24",
      "prev_date_to": "2019-08-24",
      "granularity": "day",
      "breakdown": "string",
      "all_time": false
    }
  },
  "message": "string",
  "errors": [
    "string"
  ]
}