Meta ads

The Meta ads table grouped by creator with each creator's ads, totals, quick view counts and histograms

GET/api/public/v1/meta_ads/creators
ConnectorAnswers empty results in the documented shape until the brand switches on this connection.

Operation id getMetaAdsByCreator

Request

curl

curl "https://creator.growthdept.ai/api/public/v1/meta_ads/creators" \
  -H "Authorization: Bearer gdc_..."

Parameters

NameInTypeNotes
organization_idqueryinteger
start_datequerystring (date)
end_datequerystring (date)
sortquerystringOne of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstopnamelaunched_at
metricquerystringOne of purchase_valuelast_click_revenuecreator_earningsroasspendcpaaovconversionslink_clicksctrthumbstop
directionquerystringOne of ascdesc
pagequeryinteger
per_pagequeryinteger
qquerystring
adsquerystringOne of allactivewith_gmv
creator_idsquerystring
campaign_idsquerystring
ad_set_idsquerystring
product_tagsquerystring
launchedquerystringOne of 71430
quick_viewquerystringOne of scalingburningfatiguingnew
purchase_value_minquerynumber
purchase_value_maxquerynumber
cpa_minquerynumber
cpa_maxquerynumber
spend_minquerynumber
spend_maxquerynumber
roas_minquerynumber
roas_maxquerynumber
ctr_minquerynumber
ctr_maxquerynumber
thumbstop_minquerynumber
thumbstop_maxquerynumber

Responses

200Success

FieldTypeNotes
ad_countinteger
creator_countinteger
date_rangeobject
date_range.end_datestring (date)
date_range.start_datestring (date)
directionstring
group_bystring
histogramsobject
itemsarray of object
items[].[].adsarray of object
items[].[].ads[].[].ad_namestring
items[].[].ads[].[].ad_set_idstring
items[].[].ads[].[].ad_set_namestring
items[].[].ads[].[].creative_namestring, nullable
items[].[].ads[].[].creator, nullable
items[].[].ads[].[].fatiguingboolean
items[].[].ads[].[].idstring
items[].[].ads[].[].is_newboolean
items[].[].ads[].[].launched_atstring (date-time), nullable
items[].[].ads[].[].meta_ads_countinteger
items[].[].ads[].[].metricsobject
items[].[].ads[].[].metrics.aovnumber
items[].[].ads[].[].metrics.conversionsinteger
items[].[].ads[].[].metrics.cpanumber
items[].[].ads[].[].metrics.ctrnumber
items[].[].ads[].[].metrics.last_click_commissionnumber
items[].[].ads[].[].metrics.last_click_revenuenumber
items[].[].ads[].[].metrics.link_clicksinteger
items[].[].ads[].[].metrics.purchase_valuenumber
items[].[].ads[].[].metrics.roasnumber
items[].[].ads[].[].metrics.spendnumber
items[].[].ads[].[].metrics.thumbstopnumber
items[].[].ads[].[].metrics.tw_metricsobject
items[].[].ads[].[].product_tagstring, nullable
items[].[].ads[].[].sparklinearray of number
items[].[].ads[].[].statusstringOne of activepauseddraft
items[].[].ads[].[].thumbnail_colorstring
items[].[].ads[].[].thumbnail_urlstring, nullable
items[].[].ads_active_countinteger
items[].[].ads_countinteger
items[].[].creatorobject
items[].[].creator.avatar_urlstring, nullable
items[].[].creator.colorstring
items[].[].creator.handlestring, nullable
items[].[].creator.idinteger
items[].[].creator.namestring
items[].[].fatiguingboolean
items[].[].is_newboolean
items[].[].launched_atstring, nullable
items[].[].metricsobject
items[].[].metrics.aovnumber
items[].[].metrics.conversionsinteger
items[].[].metrics.cpanumber
items[].[].metrics.ctrnumber
items[].[].metrics.last_click_commissionnumber
items[].[].metrics.last_click_revenuenumber
items[].[].metrics.link_clicksinteger
items[].[].metrics.purchase_valuenumber
items[].[].metrics.roasnumber
items[].[].metrics.spendnumber
items[].[].metrics.thumbstopnumber
items[].[].metrics.tw_metricsobject
items[].[].sparklinearray of number
metricstring
paginationobject
pagination.pageinteger
pagination.per_pageinteger
pagination.totalinteger
pagination.total_pagesinteger
quick_view_countsobject
sortstring
successboolean
totalinteger
totalsobject
totals.aovnumber
totals.conversionsinteger
totals.cpanumber
totals.ctrnumber
totals.last_click_commissionnumber
totals.last_click_revenuenumber
totals.link_clicksinteger
totals.purchase_valuenumber
totals.roasnumber
totals.spendnumber
totals.thumbstopnumber
totals.tw_metricsobject
tw_metric_columnsarray of object
tw_metric_columns[].[].keystring
tw_metric_columns[].[].labelstring
tw_metric_columns[].[].value_typestring

Example

{
  "ad_count": 3,
  "creator_count": 3,
  "date_range": {
    "end_date": "2026-11-01",
    "start_date": "2026-11-01"
  },
  "direction": "string",
  "group_by": "string",
  "histograms": {},
  "items": [
    {
      "ads": [
        {
          "ad_name": "Example name",
          "ad_set_id": "string",
          "ad_set_name": "Example name",
          "creative_name": "Example name",
          "creator": {},
          "fatiguing": true,
          "id": "string",
          "is_new": true,
          "launched_at": "2026-11-01T15:04:05Z",
          "meta_ads_count": 3,
          "metrics": {
            "aov": null,
            "conversions": null,
            "cpa": null,
            "ctr": null,
            "last_click_commission": null,
            "last_click_revenue": null,
            "link_clicks": null,
            "purchase_value": null,
            "roas": null,
            "spend": null,
            "thumbstop": null,
            "tw_metrics": null
          },
          "product_tag": "string",
          "sparkline": [
            null
          ],
          "status": "active",
          "thumbnail_color": "string",
          "thumbnail_url": "https://example.com/p/1"
        }
      ],
      "ads_active_count": 3,
      "ads_count": 3,
      "creator": {
        "avatar_url": "https://example.com/p/1",
        "color": "string",
        "handle": "string",
        "id": 1024,
        "name": "Example name"
      },
      "fatiguing": true,
      "is_new": true,
      "launched_at": "2026-11-01T15:04:05Z",
      "metrics": {
        "aov": 125.5,
        "conversions": 3,
        "cpa": 125.5,
        "ctr": 125.5,
        "last_click_commission": 125.5,
        "last_click_revenue": 125.5,
        "link_clicks": 3,
        "purchase_value": 125.5,
        "roas": 125.5,
        "spend": 125.5,
        "thumbstop": 125.5,
        "tw_metrics": {}
      },
      "sparkline": [
        125.5
      ]
    }
  ],
  "metric": "string",
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 3,
    "total_pages": 1
  },
  "quick_view_counts": {},
  "sort": "string",
  "success": true,
  "total": 3,
  "totals": {
    "aov": 125.5,
    "conversions": 3,
    "cpa": 125.5,
    "ctr": 125.5,
    "last_click_commission": 125.5,
    "last_click_revenue": 125.5,
    "link_clicks": 3,
    "purchase_value": 125.5,
    "roas": 125.5,
    "spend": 125.5,
    "thumbstop": 125.5,
    "tw_metrics": {}
  },
  "tw_metric_columns": [
    {
      "key": "string",
      "label": "string",
      "value_type": "string"
    }
  ]
}

Errors: 401404422429with an error and usually a message. See errors.

Example values are made up from each field's type and name.